action.setBadgeText()
为浏览器操作设置徽章文本。徽章显示在图标的顶部。
注意:此 API 可在清单 V3 或更高版本中使用。
没有特定徽章文本的选项卡将继承全局徽章文本,默认情况下为 ""
。
语法
js
browser.action.setBadgeText(
details // object
)
此 API 也可以作为 chrome.action.setBadgeText()
使用。
参数
details
-
具有以下属性的对象
- 如果同时提供
windowId
和tabId
,则函数将失败。 - 如果同时省略
windowId
和tabId
,则设置全局徽章。
示例
添加一个徽章来指示用户点击按钮的次数
js
let clicks = 0;
function increment() {
browser.action.setBadgeText({ text: (++clicks).toString() });
}
browser.action.onClicked.addListener(increment);
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
注意:此 API 基于 Chromium 的 chrome.action
API。此文档源自 Chromium 代码中的 browser_action.json
。