browserAction.setBadgeBackgroundColor()

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

Ab Firefox 63 wird, sofern die Badge-Textfarbe nicht explizit mittels browserAction.setBadgeTextColor() festgelegt wurde, die Badge-Textfarbe automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast zur angegebenen Badge-Hintergrundfarbe zu maximieren. Wenn Sie z.B. 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 vorzuziehen sein, eine dunkle Hintergrundfarbe zu wählen, um sicherzustellen, dass der Text gut lesbar ist.

Syntax

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

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

color

Die Farbe, angegeben als eine der folgenden Möglichkeiten:

  • 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 verändert.
  • ein browserAction.ColorArray Objekt.
  • null. Wenn eine 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.

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

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 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-Hintergrundfarbe gesetzt.

Beispiele

Eine Hintergrundfarbe, die mit Rot beginnt und auf Grün wechselt, wenn die Browseraktion angeklickt wird:

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

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

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

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

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

Beispielerweiterungen

Browser-Kompatibilität

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