action.getBadgeTextColor()
獲取瀏覽器操作徽章的文字顏色。
注意:此 API 在 Manifest V3 或更高版本中可用。
在 Firefox 中,除非使用 action.setBadgeTextColor() 顯式設定了徽章文字顏色,否則徽章文字顏色會自動設定為黑色或白色,以最大化與指定的徽章背景色的對比度。例如,如果將徽章背景色設定為白色,則預設的徽章文字顏色將設定為黑色,反之亦然。
其他瀏覽器始終使用白色文字顏色。
這是一個非同步函式,返回一個 Promise。
語法
js
browser.action.getBadgeTextColor(
details // object
)
引數
details-
object.tabId可選-
integer。指定要從中獲取徽章文字顏色的標籤頁。 windowId可選-
integer。指定要從中獲取徽章文字顏色的視窗。
- 如果同時提供了
windowId和tabId,則函式將失敗。 - 如果同時省略
windowId和tabId,則返回全域性徽章文字顏色。
返回值
一個 Promise,它將以檢索到的顏色(作為 action.ColorArray)解析。
示例
記錄徽章的文字顏色
js
function onGot(color) {
console.log(color);
}
function onFailure(error) {
console.log(error);
}
browser.action.getBadgeTextColor({}).then(onGot, onFailure);
瀏覽器相容性
載入中…
注意: 此 API 基於 Chromium 的 chrome.action API。本文件源自 Chromium 程式碼中的 browser_action.json。