From 9f4b5b8d56d0d3b05542319a1094206b4e62ef6b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Tue, 6 Aug 2024 12:48:38 +0000 Subject: [PATCH 1/3] feat: update translation --- .../api/action/gettitle/index.md | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md new file mode 100644 index 00000000000000..8f2e0755704cbb --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md @@ -0,0 +1,103 @@ +--- +title: action.getTitle() +slug: Mozilla/Add-ons/WebExtensions/API/action/getTitle +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +获取浏览器操作的标题。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高中可用。 + +就像你可以使用 {{WebExtAPIRef("action.setTitle()")}} 在每个标签上设置标题一样，你也可以通过将标签的 ID 传递给此函数来检索特定于标签的标题。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let gettingTitle = browser.action.getTitle( + 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)。 + +## 示例 + +在用户点击浏览器操作时，此代码在“this”和“that”之间切换标题： + +```js +function toggleTitle(title) { + if (title === "this") { + browser.action.setTitle({ title: "that" }); + } else { + browser.action.setTitle({ title: "this" }); + } +} + +browser.action.onClicked.addListener(() => { + let gettingTitle = browser.action.getTitle({}); + gettingTitle.then(toggleTitle); +}); +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getTitle) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 + + From 9bb6f7753b6c61c4855e1b19666fc4cf4e6e6c67 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 11:19:06 +0800 Subject: [PATCH 2/3] feat: update translation --- .../add-ons/webextensions/api/action/gettitle/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md index 8f2e0755704cbb..d0e72e6376ec14 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md @@ -10,9 +10,9 @@ l10n: 获取浏览器操作的标题。 > [!NOTE] -> 该 API 在 Manifest V3 或更高中可用。 +> 该 API 在 Manifest V3 或更高版本中可用。 -就像你可以使用 {{WebExtAPIRef("action.setTitle()")}} 在每个标签上设置标题一样，你也可以通过将标签的 ID 传递给此函数来检索特定于标签的标题。 +就像你可以使用 {{WebExtAPIRef("action.setTitle()")}} 在每个标签页上设置标题一样，你也可以通过将标签页的 ID 传递给此函数来检索特定于标签页的标题。 这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 @@ -20,7 +20,7 @@ l10n: ```js-nolint let gettingTitle = browser.action.getTitle( - details // object + details // 对象 ) ``` @@ -31,9 +31,9 @@ let gettingTitle = browser.action.getTitle( - : 一个含有下列属性的对象： - `tabId` {{optional_inline}} - - : `integer`。指定要获取标题的标签。 + - : `integer`，指定要获取标题的标签页。 - `windowId` {{optional_inline}} - - : `integer`。指定要获取标题的窗口。 + - : `integer`，指定要获取标题的窗口。 From bf46d49fb6af8b940142af0977a0ec1c11f64410 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 8 Aug 2024 10:48:17 +0800 Subject: [PATCH 3/3] feat: update translation Co-authored-by: A1lo --- .../add-ons/webextensions/api/action/gettitle/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md index d0e72e6376ec14..867ffec50c1356 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md @@ -37,12 +37,12 @@ let gettingTitle = browser.action.getTitle( -- 若同时指定了 `windowId` 和 `tabId`，则函数出错。 +- 若同时指定了 `windowId` 和 `tabId`，则函数出错且其返回的 promise 会被拒绝。 - 若同时未指定 `windowId` 和 `tabId`，则返回全局标题。 ### 返回值 -以包含浏览器操作的标题的字符串形式兑现的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。 +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)，会兑现包含浏览器操作的标题的字符串。 ## 示例 @@ -70,7 +70,7 @@ browser.action.onClicked.addListener(() => { {{Compat}} > [!NOTE] -> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getTitle) 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-getTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。