browserAction.setBadgeTextColor()
Legt die Textfarbe für das Abzeichen der Browser-Aktion fest. Tabs ohne eine spezifische Abzeichentextfarbe übernehmen die globale Abzeichentextfarbe.
Syntax
browser.browserAction.setBadgeTextColor(
details // object
)
Parameter
details
-
Ein Objekt mit den folgenden Eigenschaften:
color
-
Die Farbe, angegeben als eine der folgenden Optionen:
- ein String: jede CSS <color> Angabe, zum Beispiel
"red"
,"#FF0000"
oder"rgb(255 0 0)"
. Wenn der String keine gültige Farbe darstellt, wird das zurückgegebene Versprechen abgelehnt und die Textfarbe bleibt unverändert. - ein
Objekt.browserAction.ColorArray
null
. Wenn einetabId
angegeben ist, entfernt dies die tab-spezifische Abzeichentextfarbe, sodass der Tab die globale Abzeichentextfarbe erbt. Andernfalls wird die globale Abzeichentextfarbe auf den Standardwert zurückgesetzt.
- ein String: jede CSS <color> Angabe, zum Beispiel
tabId
Optional-
integer
. Setzt die Abzeichentextfarbe nur für den gegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab zu einer neuen Seite navigiert. windowId
Optional-
integer
. Setzt die Abzeichentextfarbe nur für das gegebene Fenster.
- Wenn
windowId
undtabId
beide angegeben sind, schlägt die Funktion fehl und die Farbe wird nicht gesetzt. - Wenn
windowId
undtabId
beide weggelassen werden, wird stattdessen die globale Abzeichentextfarbe gesetzt.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Eine Abzeichentextfarbe, die zunächst rot ist und grün wird, wenn die Browser-Aktion angeklickt wird:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });
browser.browserAction.onClicked.addListener(() => {
browser.browserAction.setBadgeTextColor({ color: "green" });
});
Setzt die Abzeichentextfarbe nur für den aktiven Tab:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });
browser.browserAction.onClicked.addListener((tab) => {
browser.browserAction.setBadgeTextColor({
color: "green",
tabId: tab.id,
});
});
Hinweis:
Diese API basiert auf Chromium's chrome.browserAction
API. Diese Dokumentation ist abgeleitet von browser_action.json
im Chromium-Code.