browserAction.setBadgeBackgroundColor()
Legt die Hintergrundfarbe für das Abzeichen fest. Tabs ohne eine spezifische Abzeichen-Hintergrundfarbe erben die globale Abzeichen-Hintergrundfarbe, die in Firefox standardmäßig [217, 0, 0, 255]
ist.
Ab Firefox 63 wird, wenn die Abzeichen-Textfarbe nicht explizit mit browserAction.setBadgeTextColor()
gesetzt wird, die Abzeichen-Textfarbe automatisch auf schwarz oder weiß gesetzt, um den Kontrast zur angegebenen Abzeichen-Hintergrundfarbe zu maximieren. Wenn Sie beispielsweise die Abzeichen-Hintergrundfarbe auf weiß setzen, wird die Standard-Abzeichen-Textfarbe auf schwarz gesetzt und umgekehrt.
Andere Browser verwenden immer eine weiße Textfarbe, daher ist es möglicherweise vorzuziehen, einen dunklen Hintergrund zu setzen, um sicherzustellen, dass der Text lesbar ist.
Syntax
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 Versprechen abgelehnt und die Hintergrundfarbe nicht geändert. - ein
-Objekt.browserAction.ColorArray
null
. Wenn einetabId
angegeben ist, wird die tab-spezifische Abzeichen-Hintergrundfarbe entfernt, sodass der Tab die globale Abzeichen-Hintergrundfarbe erbt. Andernfalls wird die globale Abzeichen-Hintergrundfarbe auf den Standardwert zurückgesetzt.
- ein String: jeder CSS <color>-Wert, zum Beispiel
tabId
Optional-
integer
. Legt die Abzeichen-Hintergrundfarbe nur für den angegebenen Tab fest. Die Farbe wird zurückgesetzt, wenn der Benutzer in diesem Tab zu einer neuen Seite navigiert. windowId
Optional-
integer
. Legt die Abzeichen-Hintergrundfarbe nur für das angegebene Fenster fest.
- Wenn sowohl
windowId
als auchtabId
angegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt. - Wenn sowohl
windowId
als auchtabId
weggelassen werden, wird stattdessen die globale Abzeichen-Hintergrundfarbe gesetzt.
Browser-Kompatibilität
BCD tables only load in the browser
Die Standardfarbe in Firefox ist: [217, 0, 0, 255]
.
Beispiele
Eine Hintergrundfarbe, die anfänglich rot ist und grün wird, wenn die Browser-Aktion angeklickt wird:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeBackgroundColor({ color: "red" });
browser.browserAction.onClicked.addListener(() => {
browser.browserAction.setBadgeBackgroundColor({ color: "green" });
});
Die Abzeichen-Hintergrundfarbe nur für den aktiven Tab festlegen:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeBackgroundColor({ color: "red" });
browser.browserAction.onClicked.addListener((tab) => {
browser.browserAction.setBadgeBackgroundColor({
color: "green",
tabId: tab.id,
});
});
Beispiel-Erweiterungen
Hinweis: Diese API basiert auf der Chromium-API chrome.browserAction
. Diese Dokumentation stammt aus browser_action.json
im Chromium-Code.