From f7076f480c75ad10b752052d36f4e738c91c1993 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Tue, 6 Aug 2024 12:45:56 +0000 Subject: [PATCH 1/4] feat: update translation --- .../api/action/getbadgetextcolor/index.md | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md new file mode 100644 index 00000000000000..9cc80572f9dc32 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md @@ -0,0 +1,102 @@ +--- +title: action.getBadgeTextColor() +slug: Mozilla/Add-ons/WebExtensions/API/action/getBadgeTextColor +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +获取浏览器操作的徽章文本颜色。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高中可用。 + +在 Firefox 中，除非使用 {{WebExtAPIRef("action.setBadgeTextColor()")}} 明确设置了徽章文本颜色，否则徽章文本颜色会自动设置为黑色或白色，以最大程度与指定的徽章背景颜色形成对比。例如，如果将徽章背景颜色设置为白色，则默认的徽章文本颜色将设置为黑色，反之亦然。 + +其他的浏览器总是使用白色作为文本颜色。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +browser.action.getBadgeTextColor( + details // object +) +``` + +### 参数 + +- `details` + + - : `object`. + + - `tabId` {{optional_inline}} + - : `integer`。指定要获取徽标文本颜色的标签。 + - `windowId` {{optional_inline}} + - : `integer`。指定要获取徽标文本颜色的窗口。 + + + +- 若同时指定了 `windowId` 和 `tabId`，则函数出错。 +- 若同时未指定 `windowId` 和 `tabId`，则返回全局徽标的文本颜色。 + +### 返回值 + +以 {{WebExtAPIRef('action.ColorArray')}} 形式兑现获取到的颜色的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。 + +## 示例 + +输出徽标的文本颜色： + +```js +function onGot(color) { + console.log(color); +} + +function onFailure(error) { + console.log(error); +} + +browser.action.getBadgeTextColor({}).then(onGot, onFailure); +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeBackgroundColor) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 + + From f78921b3e34a2a8c8f56769ff05734fd2604c59f Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 11:19:39 +0800 Subject: [PATCH 2/4] feat: update translation --- .../webextensions/api/action/getbadgetextcolor/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md index 9cc80572f9dc32..8409ffbd6dd2ee 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md @@ -10,7 +10,7 @@ l10n: 获取浏览器操作的徽章文本颜色。 > [!NOTE] -> 该 API 在 Manifest V3 或更高中可用。 +> 该 API 在 Manifest V3 或更高版本中可用。 在 Firefox 中，除非使用 {{WebExtAPIRef("action.setBadgeTextColor()")}} 明确设置了徽章文本颜色，否则徽章文本颜色会自动设置为黑色或白色，以最大程度与指定的徽章背景颜色形成对比。例如，如果将徽章背景颜色设置为白色，则默认的徽章文本颜色将设置为黑色，反之亦然。 @@ -22,7 +22,7 @@ l10n: ```js-nolint browser.action.getBadgeTextColor( - details // object + details // 对象 ) ``` @@ -33,9 +33,9 @@ browser.action.getBadgeTextColor( - : `object`. - `tabId` {{optional_inline}} - - : `integer`。指定要获取徽标文本颜色的标签。 + - : `integer`，指定要获取徽标文本颜色的标签页。 - `windowId` {{optional_inline}} - - : `integer`。指定要获取徽标文本颜色的窗口。 + - : `integer`，指定要获取徽标文本颜色的窗口。 From e534780a36f5b693e003ce3d94680937ee3dcc44 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 9 Aug 2024 11:14:58 +0800 Subject: [PATCH 3/4] Update files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md --- .../add-ons/webextensions/api/action/getbadgetextcolor/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md index 8409ffbd6dd2ee..b1d30c8f361723 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md @@ -69,7 +69,7 @@ browser.action.getBadgeTextColor({}).then(onGot, onFailure); {{Compat}} > [!NOTE] -> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeBackgroundColor) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeTextColor) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。