browserAction.setBadgeTextColor()
Legt die Textfarbe für das Badge der Browseraktion fest. Tabs ohne eine spezifische Badge-Textfarbe erben die globale Badge-Textfarbe.
Syntax
Parameter
details-
Ein Objekt mit den folgenden Eigenschaften:
color-
Die Farbe, angegeben als eine der folgenden Möglichkeiten:
- ein String: jeder CSS <color> Wert, z.B.
"red","#FF0000"oder"rgb(255 0 0)". Wenn der String keine gültige Farbe darstellt, wird das zurückgegebene Promise abgelehnt und die Textfarbe wird nicht geändert. - ein
browserAction.ColorArrayObjekt. null. Wenn eintabIdangegeben ist, wird die tab-spezifische Badge-Textfarbe entfernt, sodass der Tab die globale Badge-Textfarbe erbt. Andernfalls wird die globale Badge-Textfarbe auf den Standardwert zurückgesetzt.
- ein String: jeder CSS <color> Wert, z.B.
tabIdOptional-
integer. Legt die Badge-Textfarbe 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 Badge-Textfarbe nur für das angegebene Fenster fest.
- Wenn sowohl
windowIdals auchtabIdangegeben werden, schlägt die Funktion fehl und die Farbe wird nicht gesetzt. - Wenn
windowIdundtabIdbeide ausgelassen werden, wird stattdessen die globale Badge-Textfarbe gesetzt.
Beispiele
Eine Badge-Textfarbe, die anfängt als Rot und beim Klicken auf die Browseraktion Grün wird:
Setzen Sie die Badge-Textfarbe nur für den aktiven Tab:
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der Chromium-API chrome.browserAction. Diese Dokumentation ist abgeleitet von browser_action.json im Chromium-Code.