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