action.setBadgeTextColor()

Syntax

browser.action.setBadgeTextColor(
  details // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

color

Die Farbe, angegeben als einer der folgenden Werte:

• ein String: jedes CSS <color> Wert, zum Beispiel "red", "#FF0000", oder "rgb(255 0 0)". Wenn der String keine gültige Farbe ist, wird das zurückgegebene Promise abgelehnt und die Textfarbe wird nicht geändert.
• ein action.ColorArray Objekt.
• null. Wenn eine tabId angegeben ist, entfernt es die tab-spezifische Abzeichentextfarbe, sodass der Tab die globale Abzeichentextfarbe erbt. Andernfalls wird die globale Abzeichentextfarbe auf den Standardwert zurückgesetzt.

tabId Optional

integer. Setzt die Abzeichentextfarbe nur für den angegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab zu einer neuen Seite navigiert.

windowId Optional

integer. Setzt die Abzeichentextfarbe nur für das angegebene Fenster.

• Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt.
• Wenn sowohl windowId als auch tabId ausgelassen werden, wird stattdessen die globale Abzeichentextfarbe gesetzt.

Beispiele

Eine Abzeichentextfarbe, die zunächst rot ist und sich in grün ändert, wenn auf die Browser-Aktion geklickt wird:

browser.action.setBadgeText({ text: "1234" });
browser.action.setBadgeTextColor({ color: "red" });

browser.action.onClicked.addListener(() => {
  browser.action.setBadgeTextColor({ color: "green" });
});

Setzen Sie die Abzeichentextfarbe nur für den aktiven Tab:

browser.action.setBadgeText({ text: "1234" });
browser.action.setBadgeTextColor({ color: "red" });

browser.action.onClicked.addListener((tab) => {
  browser.action.setBadgeTextColor({
    color: "green",
    tabId: tab.id,
  });
});

Browser-Kompatibilität