From 62302e8817e8b6fa456d80e1b7bd5119875c5e88 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Tue, 6 Aug 2024 12:47:14 +0000 Subject: [PATCH 1/3] feat: update translation --- .../api/action/getpopup/index.md | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md new file mode 100644 index 00000000000000..93df79f56d02a8 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md @@ -0,0 +1,95 @@ +--- +title: action.getPopup() +slug: Mozilla/Add-ons/WebExtensions/API/action/getPopup +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +获取设为该浏览器操作的弹窗的 HTML 文档。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高中可用。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let gettingPopup = browser.action.getPopup( + details // object +) +``` + +### 参数 + +- `details` + + - : 一个含有下列属性的对象： + + - `tabId` {{optional_inline}} + - : `integer`。指定要获取弹窗的标签。 + - `windowId` {{optional_inline}} + - : `integer`。指定要获取弹窗的窗口。 + + + +- 若同时指定了 `windowId` 和 `tabId`，则函数出错。 +- 若同时未指定 `windowId` 和 `tabId`，则返回全局弹窗。 + +### 返回值 + +以包含弹窗文档的 URL 的字符串形式兑现的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。该 URL 会是一个完全合格 URL，例如 `moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html`. + +## 示例 + +获取弹窗的 URL： + +```js +function gotPopup(popupURL) { + console.log(popupURL); +} + +let gettingPopup = browser.action.getPopup({}); +gettingPopup.then(gotPopup); +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getPopup) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 + + From cc1733b125817a7c8d7c65c3f90ef3cb3628b9dd Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 11:19:07 +0800 Subject: [PATCH 2/3] feat: update translation --- .../add-ons/webextensions/api/action/getpopup/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md index 93df79f56d02a8..b1edb921101ede 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md @@ -10,7 +10,7 @@ l10n: 获取设为该浏览器操作的弹窗的 HTML 文档。 > [!NOTE] -> 该 API 在 Manifest V3 或更高中可用。 +> 该 API 在 Manifest V3 或更高版本中可用。 这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 @@ -18,7 +18,7 @@ l10n: ```js-nolint let gettingPopup = browser.action.getPopup( - details // object + details // 对象 ) ``` @@ -29,9 +29,9 @@ let gettingPopup = browser.action.getPopup( - : 一个含有下列属性的对象： - `tabId` {{optional_inline}} - - : `integer`。指定要获取弹窗的标签。 + - : `integer`，指定要获取弹窗的标签页。 - `windowId` {{optional_inline}} - - : `integer`。指定要获取弹窗的窗口。 + - : `integer`，指定要获取弹窗的窗口。 From b0bee3d4b36f749db7d1c74f08c54dc670e7db9d Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 8 Aug 2024 17:34:28 +0800 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: A1lo --- .../add-ons/webextensions/api/action/getpopup/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md index b1edb921101ede..fe022ccb8bccd8 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md @@ -40,7 +40,7 @@ let gettingPopup = browser.action.getPopup( ### 返回值 -以包含弹窗文档的 URL 的字符串形式兑现的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。该 URL 会是一个完全合格 URL，例如 `moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html`. +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)，会兑现包含弹窗文档的 URL 的字符串。该 URL 是完全限定 URL，例如 `moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html`。 ## 示例 @@ -62,7 +62,7 @@ gettingPopup.then(gotPopup); {{Compat}} > [!NOTE] -> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getPopup) 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-getPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。