action.setBadgeBackgroundColor()

Setzt die Hintergrundfarbe für das Badge. Tabs ohne spezifische Badge-Hintergrundfarbe erben die globale Badge-Hintergrundfarbe, die in Firefox standardmäßig [217, 0, 0, 255] ist.

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

In Firefox wird, sofern die Badge-Textfarbe nicht explizit mit action.setBadgeTextColor() gesetzt wird, die Badge-Textfarbe automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast mit der angegebenen Badge-Hintergrundfarbe zu maximieren. Beispielsweise, wenn Sie die Badge-Hintergrundfarbe auf Weiß setzen, wird die standardmäßige Badge-Textfarbe auf Schwarz gesetzt und umgekehrt.

Andere Browser verwenden immer eine weiße Textfarbe, daher könnte es vorzuziehen sein, einen dunklen Hintergrund zu setzen, um sicherzustellen, dass der Text lesbar ist.

Syntax

js
browser.action.setBadgeBackgroundColor(
  details // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

color

Die Farbe, die wie folgt angegeben wird:

  • 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 Versprechen abgelehnt und die Hintergrundfarbe wird nicht geändert.
  • ein action.ColorArray Objekt.
  • null. Wenn ein tabId angegeben ist, wird die tab-spezifische Badge-Hintergrundfarbe entfernt, sodass der Tab die globale Badge-Hintergrundfarbe erbt. Andernfalls wird die globale Badge-Hintergrundfarbe auf den Standardwert zurückgesetzt.
tabId Optional

integer. Setzt die Badge-Hintergrundfarbe 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-Hintergrundfarbe nur für das angegebene 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 Badge-Hintergrundfarbe gesetzt.

Beispiele

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

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

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

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

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

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

Browser-Kompatibilität

BCD tables only load in the browser

Die Standardfarbe in Firefox ist: [217, 0, 0, 255].

Hinweis: Diese API basiert auf der Chromium chrome.action API. Diese Dokumentation stammt von browser_action.json im Chromium-Code.