browserAction.setBadgeTextColor()

Legt die Textfarbe für das Abzeichen der Browser-Aktion fest. Tabs ohne eine spezifische Abzeichentextfarbe übernehmen die globale Abzeichentextfarbe.

Syntax

js
browser.browserAction.setBadgeTextColor(
  details // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

color

Die Farbe, angegeben als eine der folgenden Optionen:

  • ein String: jede CSS <color> Angabe, zum Beispiel "red", "#FF0000" oder "rgb(255 0 0)". Wenn der String keine gültige Farbe darstellt, wird das zurückgegebene Versprechen abgelehnt und die Textfarbe bleibt unverändert.
  • ein browserAction.ColorArray Objekt.
  • null. Wenn eine tabId angegeben ist, entfernt dies 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 gegebenen 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 gegebene Fenster.

  • Wenn windowId und tabId beide angegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt.
  • Wenn windowId und tabId beide weggelassen werden, wird stattdessen die globale Abzeichentextfarbe gesetzt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Eine Abzeichentextfarbe, die zunächst rot ist und grün wird, wenn die Browser-Aktion angeklickt wird:

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

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

Setzt die Abzeichentextfarbe nur für den aktiven Tab:

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

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

Hinweis: Diese API basiert auf Chromium's chrome.browserAction API. Diese Dokumentation ist abgeleitet von browser_action.json im Chromium-Code.