browserAction.setBadgeText()
设置浏览器操作的徽章文本。徽章显示在图标顶部。
没有特定徽章文本的标签页将继承全局徽章文本,默认情况下为 ""
。
语法
js
browser.browserAction.setBadgeText(
details // 对象
)
此 API 也可通过 chrome.browserAction.setBadgeText()
来使用。
参数
details
-
一个包含以下属性的对象:
text
-
string
或null
。可以传递任意数量的字符,但空间只能容纳大约四个字符。如果不需要徽章,请使用空字符串
""
。如果指定了
tabId
,null
将移除特定标签页的徽章文本,使该标签页继承全局徽章文本。否则将全局徽章文本恢复为""
。如果指定了
windowId
,null
将移除特定窗口的徽章文本,使标签页继承全局徽章文本。否则将全局徽章文本恢复为""
。 tabId
可选-
integer
。仅为指定的标签页设置徽章文本。当用户将该标签页导航到新页面时,文本会重置。 windowId
可选-
integer
。为指定的窗口设置徽章文本。
- 如果同时提供
windowId
和tabId
,函数将失败。 - 如果
windowId
和tabId
都省略,则会设置全局徽章文本。
浏览器兼容性
BCD tables only load in the browser
示例
添加一个徽章,显示用户点击按钮的次数:
js
let clicks = 0;
function increment() {
browser.browserAction.setBadgeText({ text: (++clicks).toString() });
}
browser.browserAction.onClicked.addListener(increment);
示例扩展
备注:
此 API 基于 Chromium 的 chrome.browserAction
API。该文档衍生自 Chromium 代码中的 browser_action.json
。