browserAction.setBadgeBackgroundColor()

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

Ab Firefox 63, solange die Badge-Textfarbe nicht explizit mit browserAction.setBadgeTextColor() gesetzt wurde, wird die Badge-Textfarbe automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast mit der 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 könnte es vorzuziehen sein, eine dunkle Hintergrundfarbe einzustellen, um sicherzustellen, dass der Text 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:

  • 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 Hintergrundfarbe wird nicht geändert.
  • ein browserAction.ColorArray Objekt.
  • null. Wenn eine tabId angegeben ist, entfernt es die tab-spezifische Badge-Hintergrundfarbe, 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 in diesem Tab zu einer neuen 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 sowohl windowId als auch tabId weggelassen werden, wird stattdessen die globale Badge-Hintergrundfarbe gesetzt.

Browser-Kompatibilität

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

Beispiele

Eine Hintergrundfarbe, die anfänglich rot ist und beim Klicken auf die Browseraktion grün wird:

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

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

Setzen Sie 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

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