browserAction.setBadgeTextColor()
Setzt die Textfarbe für das Badge der Browser-Aktion. Tabs ohne eine spezifische Badge-Textfarbe übernehmen die globale Badge-Textfarbe.
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: jeder CSS <color> Wert, zum Beispiel
"red"
,"#FF0000"
oder"rgb(255 0 0)"
. Ist der String keine gültige Farbe, wird das zurückgegebene Versprechen abgelehnt und die Textfarbe wird nicht geändert. - ein
browserAction.ColorArray
Objekt. null
. Wenn einetabId
angegeben ist, wird die spezifische Badge-Textfarbe des Tabs entfernt, sodass der Tab die globale Badge-Textfarbe übernimmt. Andernfalls wird die globale Badge-Textfarbe auf den Standardwert zurückgesetzt.
- ein String: jeder CSS <color> Wert, zum Beispiel
tabId
Optional-
integer
. Setzt die Badge-Textfarbe nur für den angegebenen Tab. Die Farbe wird zurückgesetzt, wenn der Benutzer diesen Tab auf eine neue Seite navigiert. windowId
Optional-
integer
. Setzt die Badge-Textfarbe nur für das angegebene Fenster.
- 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 Badge-Textfarbe gesetzt.
Beispiele
Eine Badge-Textfarbe, die als Rot beginnt und zu Grün wechselt, wenn die Browser-Aktion geklickt wird:
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });
browser.browserAction.onClicked.addListener(() => {
browser.browserAction.setBadgeTextColor({ color: "green" });
});
Setzen Sie die Badge-Textfarbe 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,
});
});
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.browserAction
API von Chromium. Diese Dokumentation stammt aus browser_action.json
im Chromium-Code.