From b80c17af761cea469bada65d927b50989193a7c7 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 30 Dec 2024 21:37:54 +0800 Subject: [PATCH 1/3] feat: update translation --- .../webextensions/api/pageaction/index.md | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md new file mode 100644 index 00000000000000..53c40028f02787 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md @@ -0,0 +1,92 @@ +--- +title: pageAction +slug: Mozilla/Add-ons/WebExtensions/API/pageAction +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +读取和修改使用 [`page_action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器地址栏按钮的属性。 + +[地址栏按钮](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions)是添加到浏览器地址栏中的一个按钮。 + +![代表一个页面操作的脚印图标](page-action.png) + +你可以在后台脚本中监听该图标的点击事件，或者指定一个在图标被点击时打开的[弹窗](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Popups)。 + +如果你指定了弹窗，可以使用 HTML、CSS 和 JavaScript 来定义其内容和行为。运行在弹出框中的 JavaScript 可以访问与后台脚本相同的 WebExtension API。尽管被称为 `pageAction`，该操作代码并不能直接访问网页内容。若需操作网页 DOM，你需要添加一个[内容脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Content_scripts)并与其交互。 + +该按钮还包含一个上下文菜单。借助 {{WebExtAPIRef("menus")}} API，你可以向该菜单添加项目（使用 `page_action` {{WebExtAPIRef("menus.ContextType")}}）。 + +页面操作适用于只与特定页面相关的功能（如“将当前标签页加入书签”）。如果功能与整个浏览器相关（如“显示所有书签”），请使用[浏览器操作](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Toolbar_button)代替。 + +## 类型 + +- {{WebExtAPIRef("pageAction.ImageDataType")}} + - : 表示图像的像素数据。 + +### 函数 + +- {{WebExtAPIRef("pageAction.show()")}} + - : 显示指定标签页的页面操作按钮。 +- {{WebExtAPIRef("pageAction.hide()")}} + - : 隐藏指定标签页的页面操作按钮。 +- {{WebExtAPIRef("pageAction.isShown()")}} + - : 检查页面操作按钮是否正在显示。 +- {{WebExtAPIRef("pageAction.setTitle()")}} + - : 设置页面操作的标题，该标题会显示在按钮的工具提示中。 +- {{WebExtAPIRef("pageAction.getTitle()")}} + - : 获取页面操作的标题。 +- {{WebExtAPIRef("pageAction.setIcon()")}} + - : 设置页面操作的图标。 +- {{WebExtAPIRef("pageAction.setPopup()")}} + - : 设置页面操作的弹窗的 URL。 +- {{WebExtAPIRef("pageAction.getPopup()")}} + - : 获取页面操作的弹窗的 URL。 +- {{WebExtAPIRef("pageAction.openPopup()")}} + - : 打开页面操作的弹出框。 + +## 事件 + +- {{WebExtAPIRef("pageAction.onClicked")}} + - : 当页面操作图标被点击时触发。如果页面操作定义了弹窗则不会触发此事件。 + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples("h2")}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.pageAction`](https://developer.chrome.google.cn/docs/extensions/mv2/reference/pageAction) API。本文衍生自 Chromium 代码中的 [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json)。 + + From b4750361ae7b39a6ebb0bb800abc4c0ca6b6d6bb Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 30 Dec 2024 21:50:00 +0800 Subject: [PATCH 2/3] Update index.md --- .../webextensions/api/pageaction/index.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md index 53c40028f02787..d56f7aac0926a2 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md @@ -7,19 +7,19 @@ l10n: {{AddonSidebar}} -读取和修改使用 [`page_action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器地址栏按钮的属性。 +读取和修改使用 [`page_action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器地址栏按钮的属性，并监听按钮的点击事件。 -[地址栏按钮](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions)是添加到浏览器地址栏中的一个按钮。 +[地址栏按钮](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions)是一个添加到浏览器地址栏中的按钮。 ![代表一个页面操作的脚印图标](page-action.png) 你可以在后台脚本中监听该图标的点击事件，或者指定一个在图标被点击时打开的[弹窗](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Popups)。 -如果你指定了弹窗，可以使用 HTML、CSS 和 JavaScript 来定义其内容和行为。运行在弹出框中的 JavaScript 可以访问与后台脚本相同的 WebExtension API。尽管被称为 `pageAction`，该操作代码并不能直接访问网页内容。若需操作网页 DOM，你需要添加一个[内容脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Content_scripts)并与其交互。 +如果你指定了弹窗，你可以使用 HTML、CSS 和 JavaScript 来定义其内容和行为。运行在弹出框中的 JavaScript 可以访问与后台脚本相同的 WebExtension API。尽管被称为 `pageAction`，该操作代码并不能直接访问网页内容。若需操作网页 DOM，你需要添加一个[内容脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Content_scripts)并与其交互。 -该按钮还包含一个上下文菜单。借助 {{WebExtAPIRef("menus")}} API，你可以向该菜单添加项目（使用 `page_action` {{WebExtAPIRef("menus.ContextType")}}）。 +该按钮还包含一个上下文菜单。借助 {{WebExtAPIRef("menus")}} API，你可以通过使用 `page_action` {{WebExtAPIRef("menus.ContextType")}} 来向该菜单添加项目。 -页面操作适用于只与特定页面相关的功能（如“将当前标签页加入书签”）。如果功能与整个浏览器相关（如“显示所有书签”），请使用[浏览器操作](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Toolbar_button)代替。 +页面操作适用于只与特定页面相关的功能（如“将当前标签页加入书签”）。如果功能与整个浏览器相关（如“显示所有书签”），则请使用[浏览器操作](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Toolbar_button)。 ## 类型 @@ -29,13 +29,13 @@ l10n: ### 函数 - {{WebExtAPIRef("pageAction.show()")}} - - : 显示指定标签页的页面操作按钮。 + - : 在指定标签页中显示页面操作按钮。 - {{WebExtAPIRef("pageAction.hide()")}} - - : 隐藏指定标签页的页面操作按钮。 + - : 在指定标签页中隐藏页面操作按钮。 - {{WebExtAPIRef("pageAction.isShown()")}} - : 检查页面操作按钮是否正在显示。 - {{WebExtAPIRef("pageAction.setTitle()")}} - - : 设置页面操作的标题，该标题会显示在按钮的工具提示中。 + - : 设置页面操作的标题。该标题会显示在按钮的工具提示中。 - {{WebExtAPIRef("pageAction.getTitle()")}} - : 获取页面操作的标题。 - {{WebExtAPIRef("pageAction.setIcon()")}} @@ -45,12 +45,12 @@ l10n: - {{WebExtAPIRef("pageAction.getPopup()")}} - : 获取页面操作的弹窗的 URL。 - {{WebExtAPIRef("pageAction.openPopup()")}} - - : 打开页面操作的弹出框。 + - : 打开页面操作的弹窗。 ## 事件 - {{WebExtAPIRef("pageAction.onClicked")}} - - : 当页面操作图标被点击时触发。如果页面操作定义了弹窗则不会触发此事件。 + - : 当页面操作图标被点击时触发。如果页面操作有弹窗，则该事件将不会被触发。 ## 浏览器兼容性 From bc985bef5a37b7b01e72351f57b5c712380a000b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 6 Jan 2025 12:12:45 +0800 Subject: [PATCH 3/3] Update files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md index d56f7aac0926a2..1d834b2c223369 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/index.md @@ -26,7 +26,7 @@ l10n: - {{WebExtAPIRef("pageAction.ImageDataType")}} - : 表示图像的像素数据。 -### 函数 +## 函数 - {{WebExtAPIRef("pageAction.show()")}} - : 在指定标签页中显示页面操作按钮。