Spec-Zone.ru › Web Extensions

browserAction.setBadgeTextColor()

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

Синтаксис

browser.browserAction.setBadgeTextColor(
  details // object
)

Параметры

details

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

color

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

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

integer. Устанавливает цвет текста значка только для заданной вкладки. Цвет сбрасывается, когда пользователь переходит на новую страницу в этой вкладке.

windowId Необязательно

integer. Устанавливает цвет текста значка только для заданной вкладки.

  • Если windowId и tabId оба заданы, функция завершается неудачно, и цвет не устанавливается.
  • Если windowId и tabId оба опущены, вместо этого устанавливается глобальный цвет текста значка.

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
setBadgeTextColor Нет Нет 63 ? Нет Нет ? ? 79 ? Нет ?

Примеры

Цвет текста значка, который изначально красный, и становится зелёным, когда нажато действие браузера:

browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.setBadgeTextColor({ color: "green" });
});

Установите цвет текста значка только для активной вкладки:

browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });

browser.browserAction.onClicked.addListener((tab) => {
  browser.browserAction.setBadgeTextColor({
    color: "green",
    tabId: tab.id,
  });
});

Примечание: Этот API основан на API chrome.browserAction 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/browserAction/setBadgeTextColor

Spec-Zone.ru

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