action.setBadgeTextColor()
Устанавливает цвет текста для значка действия браузера. Вкладки без определенного цвета текста значка будут наследоваться от глобального цвета текста значка.
Примечание: Этот API доступен в Manifest V3 или выше.
Синтаксис
browser.action.setBadgeTextColor( details // object )
Параметры
details-
Объект со следующими свойствами:
color-
Цвет, заданный как один из:
- строка: любое значение CSS <color>, например
"red","#FF0000", или"rgb(255,0,0)". Если строка не является допустимым цветом, возвращаемое обещание будет отклонено, и цвет текста не будет изменён. - объект
.action.ColorArray -
null. Если указанtabId, он удаляет цвет текста значка, специфичный для вкладки, чтобы вкладка унаследовала глобальный цвет текста значка. В противном случае он возвращает глобальный цвет текста значка к значению по умолчанию.
- строка: любое значение CSS <color>, например
-
tabIdНеобязательно -
integer. Устанавливает цвет текста значка только для данной вкладки. Цвет сбрасывается, когда пользователь переходит в этой вкладке на новую страницу. -
windowIdНеобязательно -
integer. Устанавливает цвет текста значка только для данной вкладки.
- Если
windowIdиtabIdоба указаны, функция завершается сбоем, и цвет не устанавливается. - Если
windowIdиtabIdоба пропущены, вместо этого устанавливается глобальный цвет текста значка.
Примеры
Цвет текста значка, который изначально красный, и становится зелёным при нажатии на действие браузера:
browser.action.setBadgeText({ text: "1234" }); browser.action.setBadgeTextColor({ color: "red" }); browser.action.onClicked.addListener(() => { browser.action.setBadgeTextColor({ color: "green" }); });
Установить цвет текста значка только для активной вкладки:
browser.action.setBadgeText({ text: "1234" }); browser.action.setBadgeTextColor({ color: "red" }); browser.action.onClicked.addListener((tab) => { browser.action.setBadgeTextColor({ color: "green", tabId: tab.id, }); });
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
setBadgeTextColor |
Нет | Нет | 109 | ? | Нет | Нет | ? | ? | 109 | ? | Нет | ? |
Примечание: Этот API основан на API chrome.action Chromium. Данная документация взята из browser_action.json кода Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/action/setBadgeTextColor