browserAction.setBadgeBackgroundColor()
Legt die Hintergrundfarbe für das Badge fest. Tabs ohne eine spezifische Hintergrundfarbe für das Badge erben die globale Hintergrundfarbe für Badges, die in Firefox standardmäßig [217, 0, 0, 255] ist.
Ab Firefox 63 wird, wenn die Badge-Textfarbe nicht ausdrücklich mit browserAction.setBadgeTextColor() festgelegt wird, die Badge-Textfarbe automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast mit der angegebenen Badge-Hintergrundfarbe zu maximieren. Wenn Sie zum Beispiel die Badge-Hintergrundfarbe auf Weiß setzen, wird die standardmäßige Badge-Textfarbe auf Schwarz gesetzt und umgekehrt.
Andere Browser verwenden immer eine weiße Textfarbe, daher kann es vorzuziehen sein, 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 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 Promise abgelehnt und die Hintergrundfarbe wird nicht geändert. - ein
browserAction.ColorArrayObjekt. null. Wenn eintabIdangegeben ist, wird die tabspezifische Badgehintergrundfarbe entfernt, sodass der Tab die globale Badgehintergrundfarbe erbt. Andernfalls wird die globale Badgehintergrundfarbe auf den Standardwert zurückgesetzt.
Die Standardfarbe in Firefox ist:
[217, 0, 0, 255]. - ein String: jeder CSS <color> Wert, zum Beispiel
tabIdOptional-
integer. Legt die Badgehintergrundfarbe nur für den angegebenen Tab fest. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab zu einer neuen Seite navigiert. windowIdOptional-
integer. Legt die Badgehintergrundfarbe nur für das angegebene Fenster fest.
- Wenn sowohl
windowIdals auchtabIdangegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt. - Wenn sowohl
windowIdals auchtabIdweggelassen werden, wird stattdessen die globale Badgehintergrundfarbe gesetzt.
Beispiele
Eine Hintergrundfarbe, die zunächst rot ist und grün wird, wenn auf die Browseraktion geklickt wird:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeBackgroundColor({ color: "red" });
browser.browserAction.onClicked.addListener(() => {
browser.browserAction.setBadgeBackgroundColor({ color: "green" });
});
Legen Sie die Badgehintergrundfarbe nur für den aktiven Tab fest:
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 Chromiums chrome.browserAction API. Diese Dokumentation ist abgeleitet von browser_action.json im Chromium-Code.