From 01d130237371fdae40182ca5d73a969bef395932 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 30 Dec 2024 21:40:36 +0800 Subject: [PATCH 1/4] feat: update translation --- .../api/pageaction/onclicked/index.md | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md new file mode 100644 index 00000000000000..63b32d433f183d --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md @@ -0,0 +1,102 @@ +--- +title: pageAction.onClicked +slug: Mozilla/Add-ons/WebExtensions/API/pageAction/onClicked +l10n: + sourceCommit: acc6ec7d08ede0727a68cbc696e983c572940f62 +--- + +{{AddonSidebar}} + +当页面操作图标被点击时触发。如果页面操作有一个弹出窗口，则此事件不会触发。 + +要定义右键单击操作，请使用 {{WebExtAPIRef('contextMenus')}} API（使用 `page_action` {{WebExtAPIRef('contextMenus/ContextType', 'context type', '', 'nocode')}}）。 + +## 语法 + +```js-nolint +browser.pageAction.onClicked.addListener(listener) +browser.pageAction.onClicked.removeListener(listener) +browser.pageAction.onClicked.hasListener(listener) +``` + +事件有三个函数： + +- `addListener(listener)` + - : 为该事件添加监听器。 +- `removeListener(listener)` + - : 停止监听此事件。`listener` 参数是要移除的监听器。 +- `hasListener(listener)` + - : 检查是否已为此事件注册了 `listener`。如果正在监听，则返回 `true`，否则返回 `false`。 + +## addListener 语法 + +### 参数 + +- `listener` + + - : 当该事件发生时要调用的函数。该函数接收如下参数： + + - `tab` + - : 一个表示被点击的页面操作的标签页的 {{WebExtAPIRef('tabs.Tab')}} 对象。 + - `OnClickData` + + - : 包含有关点击的信息的对象。 + + - `modifiers` + - : `array`。点击时激活的键盘修饰符，可以是 `Shift`、`Alt`、`Command`、`Ctrl` 或 `MacCtrl` 中的一个或多个。 + - `button` + - : `integer`。指示用于点击页面操作图标的按钮：`0` 表示左键单击或不与鼠标相关的点击，例如键盘点击，`1` 表示中键或滚轮点击。请注意，此处并不支持右键单击，因为 Firefox 在触发此事件之前会消耗该点击以显示上下文菜单。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +以下示例演示了如何在用户单击页面操作时隐藏该操作并将活动标签页导航到“”： + +```js +let catGifs = "https://giphy.com/explore/cat"; + +browser.pageAction.onClicked.addListener((tab) => { + browser.pageAction.hide(tab.id); + browser.tabs.update({ url: catGifs }); +}); + +browser.pageAction.onClicked.addListener(() => {}); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.pageAction`](https://developer.chrome.google.cn/docs/extensions/mv2/reference/pageAction#event-onClicked) API。本文衍生自 Chromium 代码中的 [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json)。 + + From 7ea16c4f0212ee1bc626f0f37bc03fdaafdd2dbd Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 30 Dec 2024 22:10:11 +0800 Subject: [PATCH 2/4] Update index.md --- .../webextensions/api/pageaction/onclicked/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md index 63b32d433f183d..9c746615ac32d4 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md @@ -7,7 +7,7 @@ l10n: {{AddonSidebar}} -当页面操作图标被点击时触发。如果页面操作有一个弹出窗口，则此事件不会触发。 +当页面操作图标被点击时触发。如果页面操作有弹窗，则该事件将不会被触发。 要定义右键单击操作，请使用 {{WebExtAPIRef('contextMenus')}} API（使用 `page_action` {{WebExtAPIRef('contextMenus/ContextType', 'context type', '', 'nocode')}}）。 @@ -43,9 +43,9 @@ browser.pageAction.onClicked.hasListener(listener) - : 包含有关点击的信息的对象。 - `modifiers` - - : `array`。点击时激活的键盘修饰符，可以是 `Shift`、`Alt`、`Command`、`Ctrl` 或 `MacCtrl` 中的一个或多个。 + - : `array`。点击页面操作按钮时使用的键盘修饰符，可以是 `Shift`、`Alt`、`Command`、`Ctrl` 或 `MacCtrl` 中的一个或多个。 - `button` - - : `integer`。指示用于点击页面操作图标的按钮：`0` 表示左键单击或不与鼠标相关的点击，例如键盘点击，`1` 表示中键或滚轮点击。请注意，此处并不支持右键单击，因为 Firefox 在触发此事件之前会消耗该点击以显示上下文菜单。 + - : `integer`。指示用于点击页面操作图标的按钮：`0` 表示左键单击或不与鼠标相关的点击（例如键盘点击），`1` 表示中键或滚轮点击。请注意，此处并不支持右键单击，因为 Firefox 在触发此事件之前会消耗右键单击以显示上下文菜单。 ## 浏览器兼容性 @@ -53,7 +53,7 @@ browser.pageAction.onClicked.hasListener(listener) ## 示例 -以下示例演示了如何在用户单击页面操作时隐藏该操作并将活动标签页导航到“”： +以下示例演示了如何在用户单击页面操作时隐藏该页面操作，并将活动标签页导航到“”： ```js let catGifs = "https://giphy.com/explore/cat"; From 4610a74c956e1326297b5aad07e4969894a19ce7 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 2 Jan 2025 20:28:04 +0800 Subject: [PATCH 3/4] Update index.md --- .../add-ons/webextensions/api/pageaction/onclicked/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md index 9c746615ac32d4..3785d51bd86ed9 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md @@ -9,7 +9,7 @@ l10n: 当页面操作图标被点击时触发。如果页面操作有弹窗，则该事件将不会被触发。 -要定义右键单击操作，请使用 {{WebExtAPIRef('contextMenus')}} API（使用 `page_action` {{WebExtAPIRef('contextMenus/ContextType', 'context type', '', 'nocode')}}）。 +要定义右键单击操作，请使用{{WebExtAPIRef('contextMenus', "上下文菜单", "", "nocode")}} API（使用 `page_action` {{WebExtAPIRef('contextMenus/ContextType', '上下文类型', '', 'nocode')}}）。 ## 语法 From 9fb6b662a343f83113afbfd57d5c3159a386e513 Mon Sep 17 00:00:00 2001 From: A1lo Date: Sat, 18 Jan 2025 22:01:03 +0800 Subject: [PATCH 4/4] Update files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md --- .../add-ons/webextensions/api/pageaction/onclicked/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md index 3785d51bd86ed9..ccf1d26e62cd31 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md @@ -45,7 +45,7 @@ browser.pageAction.onClicked.hasListener(listener) - `modifiers` - : `array`。点击页面操作按钮时使用的键盘修饰符，可以是 `Shift`、`Alt`、`Command`、`Ctrl` 或 `MacCtrl` 中的一个或多个。 - `button` - - : `integer`。指示用于点击页面操作图标的按钮：`0` 表示左键单击或不与鼠标相关的点击（例如键盘点击），`1` 表示中键或滚轮点击。请注意，此处并不支持右键单击，因为 Firefox 在触发此事件之前会消耗右键单击以显示上下文菜单。 + - : `integer`。指示用于点击页面操作图标的按钮：`0` 表示左键单击或不与鼠标相关的点击（例如键盘点击），`1` 表示中键或滚轮点击。请注意，并不支持右键单击，因为 Firefox 在触发此事件之前会消耗右键单击以显示上下文菜单。 ## 浏览器兼容性