Spec-Zone.ru › Web Extensions

action.setBadgeTextColor()

Устанавливает цвет текста для значка действия браузера. Вкладки без определенного цвета текста значка будут наследоваться от глобального цвета текста значка.

Примечание: Этот API доступен в Manifest V3 или выше.

Синтаксис

browser.action.setBadgeTextColor(
  details // object
)

Параметры

details

Объект со следующими свойствами:

color

Цвет, заданный как один из:

  • строка: любое значение CSS <color>, например "red", "#FF0000", или "rgb(255,0,0)". Если строка не является допустимым цветом, возвращаемое обещание будет отклонено, и цвет текста не будет изменён.
  • объект action.ColorArray.
  • null. Если указан tabId, он удаляет цвет текста значка, специфичный для вкладки, чтобы вкладка унаследовала глобальный цвет текста значка. В противном случае он возвращает глобальный цвет текста значка к значению по умолчанию.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API