browserAction.setBadgeTextColor()

设置浏览器操作徽章的文本颜色。没有特定徽章文本颜色的标签页将继承全局徽章文本颜色。

语法

js
browser.browserAction.setBadgeTextColor(
  details // 对象
)

参数

details

一个包含以下属性的对象：

color

颜色，可以指定为以下之一：

  • 字符串：任何 CSS <color> 值，例如 "red"、"#FF0000" 或 "rgb(255 0 0)"。如果字符串不是有效颜色，返回的 Promise 将被拒绝，并且文本颜色不会更改。
  • browserAction.ColorArray 对象。
  • null。如果指定了 tabId，则移除特定标签页的徽章文本颜色，使该标签页继承全局徽章文本颜色。否则将全局徽章文本颜色恢复为默认值。
tabId 可选

integer。仅为指定的标签页设置徽章文本颜色。当用户将该标签页导航到新页面时，颜色会重置。

windowId 可选

integer。仅为指定的窗口设置徽章文本颜色。

  • 如果同时提供 windowId 和 tabId，函数将失败且颜色不会被设置。
  • 如果 windowId 和 tabId 都省略，则设置全局徽章文本颜色。

浏览器兼容性

BCD tables only load in the browser

示例

徽章文本颜色起初为红色，当浏览器操作被点击时变为绿色：

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

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

仅为活动标签页设置徽章文本颜色：

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

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

备注： 此 API 基于 Chromium 的 chrome.browserAction API。该文档衍生自 Chromium 代码中的 browser_action.json。