browserAction.setBadgeTextColor()

設定瀏覽器操作徽章上的文字顏色。沒有特定徽章文字顏色的標籤頁將繼承全域性徽章文字顏色。

語法

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

引數

details

具有以下屬性的物件:

color

顏色,指定為以下之一:

  • 一個字串:任何 CSS <color> 值,例如 "red""#FF0000""rgb(255 0 0)"。如果字串不是有效的顏色,返回的 Promise 將被拒絕,文字顏色也不會被更改。
  • 一個 browserAction.ColorArray 物件。
  • null。如果指定了 tabId,則會移除標籤頁特定的徽章文字顏色,以便該標籤頁繼承全域性徽章文字顏色。否則,它會將全域性徽章文字顏色恢復到預設值。
tabId 可選

integer。僅為指定的標籤頁設定徽章文字顏色。當用戶將此標籤頁導航到新頁面時,顏色將被重置。

windowId 可選

integer。僅為指定的視窗設定徽章文字顏色。

  • 如果同時提供了 windowIdtabId,則函式將失敗,顏色不會被設定。
  • 如果同時省略了 windowIdtabId,則會設定全域性徽章文字顏色。

示例

一個徽章文字顏色,最初為紅色,在瀏覽器操作被點選時變為綠色

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