action.setBadgeTextColor()
設定瀏覽器操作圖示徽章的文字顏色。沒有特定徽章文字顏色的標籤頁將繼承全域性徽章文字顏色。
注意：此 API 在 Manifest V3 或更高版本中可用。
語法
js
browser.action.setBadgeTextColor(
details // object
)
引數
details-
具有以下屬性的物件：
color-
顏色，指定為以下之一：
- 字串：任何 CSS <color> 值，例如
"red"、"#FF0000"或"rgb(255 0 0)"。如果字串不是有效的顏色，返回的 Promise 將被拒絕，並且文字顏色不會被更改。 - 一個
action.ColorArray物件。 null。如果指定了tabId，則會移除標籤頁特定的徽章文字顏色，以便該標籤頁繼承全域性徽章文字顏色。否則，它會將全域性徽章文字顏色恢復為預設值。
- 字串：任何 CSS <color> 值，例如
tabId可選-
integer。僅為給定的標籤頁設定徽章文字顏色。當用戶將此標籤頁導航到新頁面時，顏色將被重置。 windowId可選-
integer。僅為給定的視窗設定徽章文字顏色。
- 如果同時提供了
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,
});
});
瀏覽器相容性
載入中…
注意：此 API 基於 Chromium 的 chrome.action API。本文件源自 Chromium 程式碼中的 browser_action.json。