browserAction.setBadgeTextColor()

Syntax

browser.browserAction.setBadgeTextColor(
  details // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

color

Die Farbe, angegeben als eine der folgenden Optionen:

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

tabId Optional

integer. Setzt die Badge-Textfarbe nur für den angegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab auf eine neue Seite navigiert.

windowId Optional

integer. Setzt die Badge-Textfarbe 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 weggelassen werden, wird stattdessen die globale Badge-Textfarbe gesetzt.

Beispiele

Eine Badge-Textfarbe, die als Rot beginnt und zu Grün wechselt, wenn die Browser-Aktion geklickt wird:

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

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

Setzen Sie die Badge-Textfarbe nur für den aktiven Tab:

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

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

Browser-Kompatibilität