action.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 auf [217, 0, 0, 255] gesetzt 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() festgelegt, wird die Textfarbe des Badges automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast zur angegebenen Badge-Hintergrundfarbe zu maximieren. Wenn Sie zum Beispiel die Badge-Hintergrundfarbe 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, eine dunkle Hintergrundfarbe zu setzen, 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 der folgenden:
- ein String: jeder CSS <color> Wert, zum Beispiel
"red","#FF0000", oder"rgb(255 0 0)". Ist der String keine gültige Farbe, wird das zurückgegebene Promise abgelehnt und die Hintergrundfarbe wird nicht verändert. - ein
action.ColorArray-Objekt. null. Wenn einetabIdangegeben ist, wird die tab-spezifische Badge-Hintergrundfarbe entfernt, so dass 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]. - ein String: jeder CSS <color> Wert, zum Beispiel
tabIdOptional-
integer. Setzt die Badge-Hintergrundfarbe nur für den angegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Nutzer den Tab auf eine neue Seite navigiert. windowIdOptional-
integer. Setzt die Badge-Hintergrundfarbe 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 Badge-Hintergrundfarbe gesetzt.
Beispiele
Eine Hintergrundfarbe, die anfangs rot ist und grün wird, wenn die Browser-Aktion angeklickt wird:
browser.action.setBadgeText({ text: "1234" });
browser.action.setBadgeBackgroundColor({ color: "red" });
browser.action.onClicked.addListener(() => {
browser.action.setBadgeBackgroundColor({ color: "green" });
});
Setzen der Badge-Hintergrundfarbe 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
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.action API. Diese Dokumentation stammt aus browser_action.json im Chromium-Code.