browserAction.setBadgeTextColor()

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

语法

js
browser.browserAction.setBadgeTextColor(
  details // object
)

参数

details

具有以下属性的对象

color

颜色，指定为以下之一

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

整数。仅为给定标签设置徽章文本颜色。当用户将此标签导航到新页面时，颜色将重置。

windowId 可选

整数。仅为给定窗口设置徽章文本颜色。

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

徽章文本颜色最初为红色，点击浏览器操作后变为绿色

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。此文档来自 browser_action.json 在 Chromium 代码中。