action.setBadgeBackgroundColor()
Setzt die Hintergrundfarbe für das Badge. Tabs ohne spezifische Hintergrundfarbe des Badges übernehmen die globale Hintergrundfarbe des Badges, die in Firefox standardmäßig [217, 0, 0, 255] ist.
Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.
In Firefox, es sei denn, die Textfarbe des Badges wird explizit mit action.setBadgeTextColor() gesetzt, wird die Textfarbe des Badges automatisch auf Schwarz oder Weiß eingestellt, um den Kontrast mit der angegebenen Hintergrundfarbe des Badges zu maximieren. Beispielsweise, wenn Sie die Hintergrundfarbe des Badges auf Weiß setzen, wird die Standard-Textfarbe des Badges auf Schwarz gesetzt und umgekehrt.
Andere Browser verwenden immer eine weiße Textfarbe, daher kann es vorzuziehen sein, einen dunklen Hintergrund festzulegen, um sicherzustellen, dass der Text lesbar ist.
Syntax
browser.action.setBadgeBackgroundColor(
details // object
)
Parameter
details-
Ein Objekt mit den folgenden Eigenschaften:
color-
Die Farbe, angegeben als eine von:
- ein String: ein beliebiger 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
action.ColorArrayObjekt. null. Wenn einetabIdangegeben ist, wird die tab-spezifische Hintergrundfarbe des Badges entfernt, sodass der Tab die globale Hintergrundfarbe des Badges erbt. Andernfalls wird die globale Hintergrundfarbe des Badges auf den Standardwert zurückgesetzt.
Der Standardwert der Farbe in Firefox ist:
[217, 0, 0, 255]. - ein String: ein beliebiger CSS <color> Wert, zum Beispiel
tabIdOptional-
integer. Setzt die Hintergrundfarbe des Badges nur für den angegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab zu einer neuen Seite navigiert. windowIdOptional-
integer. Setzt die Hintergrundfarbe des Badges nur für das angegebene Fenster.
- Wenn
windowIdundtabIdbeide angegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt. - Wenn
windowIdundtabIdbeide weggelassen werden, wird stattdessen die globale Hintergrundfarbe des Badges gesetzt.
Beispiele
Eine Hintergrundfarbe, die zunächst rot ist und grün wird, wenn die Browser-Aktion geklickt wird:
browser.action.setBadgeText({ text: "1234" });
browser.action.setBadgeBackgroundColor({ color: "red" });
browser.action.onClicked.addListener(() => {
browser.action.setBadgeBackgroundColor({ color: "green" });
});
Setzen der Hintergrundfarbe des Badges nur für den aktiven Tab:
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
Hinweis:
Diese API basiert auf Chromiums chrome.action API. Diese Dokumentation stammt aus browser_action.json im Chromium-Code.