action.setBadgeTextColor()

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

注意：此 API 在清单 V3 或更高版本中可用。

语法

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

参数

details

具有以下属性的对象

color

颜色，指定为以下之一

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

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

windowId 可选

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

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

示例

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

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

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

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

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

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

浏览器兼容性

BCD 表格仅在浏览器中加载

注意：此 API 基于 Chromium 的 chrome.action API。此文档源自 browser_action.json 在 Chromium 代码中。