From 9c0aa7fd1327abb1ef407d35186b53f572229544 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Tue, 6 Aug 2024 12:44:43 +0000 Subject: [PATCH 1/4] feat: update translation --- .../api/action/getbadgetext/index.md | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md new file mode 100644 index 00000000000000..82255a4a342f7a --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md @@ -0,0 +1,95 @@ +--- +title: action.getBadgeText() +slug: Mozilla/Add-ons/WebExtensions/API/action/getBadgeText +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +获取浏览器操作的徽章文本。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高中可 b30a10c08b986ebabd44733fb62f67667350403e 用。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let gettingText = browser.action.getBadgeText( + details // object +) +``` + +### 参数 + +- `details` + + - : 一个含有下列属性的对象: + + - `tabId` {{optional_inline}} + - : `integer`。指定要获取徽标文本的标签。 + - `windowId` {{optional_inline}} + - : `integer`。指定要获取徽标文本的窗口。 + + + +- 若同时指定了 `windowId` 和 `tabId`,则函数出错。 +- 若同时未指定 `windowId` 和 `tabId`,则返回全局徽标的文本。 + +### 返回值 + +以字符串形式兑现徽标文本的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。 + +## 示例 + +输出徽标文本: + +```js +function gotBadgeText(text) { + console.log(text); +} + +let gettingBadgeText = browser.action.getBadgeText({}); +gettingBadgeText.then(gotBadgeText); +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeText) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 + + From 588582bbc570c8d2183285b6ade4881d36c681ca Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 11:20:20 +0800 Subject: [PATCH 2/4] feat: update translation --- .../webextensions/api/action/getbadgetext/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md index 82255a4a342f7a..48819cf4425ef3 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md @@ -10,7 +10,7 @@ l10n: 获取浏览器操作的徽章文本。 > [!NOTE] -> 该 API 在 Manifest V3 或更高中可 b30a10c08b986ebabd44733fb62f67667350403e 用。 +> 该 API 在 Manifest V3 或更高版本中可用。 这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 @@ -18,7 +18,7 @@ l10n: ```js-nolint let gettingText = browser.action.getBadgeText( - details // object + details // 对象 ) ``` @@ -29,9 +29,9 @@ let gettingText = browser.action.getBadgeText( - : 一个含有下列属性的对象: - `tabId` {{optional_inline}} - - : `integer`。指定要获取徽标文本的标签。 + - : `integer`,指定要获取徽标文本的标签页。 - `windowId` {{optional_inline}} - - : `integer`。指定要获取徽标文本的窗口。 + - : `integer`,指定要获取徽标文本的窗口。 From 4b5bde48e61b4e26eca7604635592a4f5a460f7c Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 8 Aug 2024 17:41:05 +0800 Subject: [PATCH 3/4] Update files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md --- .../add-ons/webextensions/api/action/getbadgetext/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md index 48819cf4425ef3..88c748a2c84cc9 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md @@ -62,7 +62,7 @@ gettingBadgeText.then(gotBadgeText); {{Compat}} > [!NOTE] -> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeText) 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-getBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 - 若同时指定了 `windowId` 和 `tabId`,则函数出错。 -- 若同时未指定 `windowId` 和 `tabId`,则返回全局徽标的文本。 +- 若同时未指定 `windowId` 和 `tabId`,则返回全局的徽章文本。 ### 返回值 -以字符串形式兑现徽标文本的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。 +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),会兑现包含徽章文本的字符串。 ## 示例 -输出徽标文本: +输出徽章文本: ```js function gotBadgeText(text) {