action.setBadgeTextColor()

Legt die Textfarbe für das Badge der Browser-Aktion fest. Tabs ohne eine spezifische Badge-Textfarbe erben die globale Badge-Textfarbe.

Hinweis: Diese API ist ab Manifest V3 oder höher verfügbar.

Syntax

js
browser.action.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)". 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 ein tabId angegeben wird, entfernt es die tab-spezifische Badge-Textfarbe, sodass der Tab die globale Badge-Textfarbe erbt. 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 zu einer neuen 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 weder windowId noch tabId angegeben werden, wird stattdessen die globale Badge-Textfarbe gesetzt.

Beispiele

Eine Badge-Textfarbe, die rot beginnt und grün wird, wenn auf die Browser-Aktion geklickt wird:

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

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

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

js
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

Hinweis: Diese API basiert auf Chromiums chrome.action API. Diese Dokumentation ist aus browser_action.json im Chromium-Code abgeleitet.