action.setBadgeBackgroundColor()

Setzt die Hintergrundfarbe für das Badge. Tabs ohne eine 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() festgelegt wurde, die Badge-Textfarbe automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast zur angegebenen Badge-Hintergrundfarbe zu maximieren. Zum Beispiel, wenn Sie die Badge-Hintergrundfarbe auf Weiß setzen, wird die Standard-Badge-Textfarbe auf Schwarz gesetzt, und umgekehrt.

Andere Browser verwenden immer eine weiße Textfarbe. Daher kann es vorteilhaft sein, einen dunklen Hintergrund einzustellen, 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, angegeben als eine von:

  • ein String: jeder CSS-<color>-Wert, zum Beispiel "red", "#FF0000", oder "rgb(255 0 0)". Wenn der String keine gültige Farbe darstellt, wird das zurückgegebene Promise abgelehnt und die Hintergrundfarbe wird nicht verä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 zu einer neuen Seite navigiert.

windowId Optional

integer. Setzt die Badge-Hintergrundfarbe 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 sind, wird stattdessen die globale Badge-Hintergrundfarbe festgelegt.

Beispiele

Eine Hintergrundfarbe, die zunächst rot ist und grün wird, wenn die Browser-Aktion angeklickt 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 Chromium's chrome.action API. Diese Dokumentation stammt aus browser_action.json im Chromium-Code.