Spec-Zone.ru › Web Extensions

action.setBadgeText()

Устанавливает текст значка для действия браузера. Значок отображается сверху иконки.

Примечание: Этот API доступен в манифесте V3 или более поздней версии.

Вкладки без конкретного текста значка унаследуют глобальный текст значка, который по умолчанию равен "".

Синтаксис

browser.action.setBadgeText(
  details // object
)

Этот API также доступен как chrome.action.setBadgeText().

Параметры

details

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

text

string или null. Можно передать любое количество символов, но в поле поместится приблизительно четыре.

Используйте пустую строку - "" - если вы не хотите отображать значок.

Если задан tabId, null удаляет текст значка, специфичный для вкладки, чтобы вкладка унаследовала глобальный текст значка. В противном случае глобальный текст значка восстанавливается до "".

Если задан windowId, null удаляет текст значка, специфичный для окна, чтобы вкладка унаследовала глобальный текст значка. В противном случае глобальный текст значка восстанавливается до "".

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

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

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

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

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

Примеры

Добавьте значок, показывающий количество нажатий на кнопку пользователем:

let clicks = 0;

function increment() {
  browser.action.setBadgeText({ text: (++clicks).toString() });
}

browser.action.onClicked.addListener(increment);

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet
setBadgeText 88 88 109 ? 74 Нет ? ? 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/setBadgeText

Spec-Zone.ru

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