From 164916d7d81f8f72390bd60e3b214e29d28094dc Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 05:01:30 +0000 Subject: [PATCH 1/5] feat: update translation --- .../add-ons/webextensions/api/action/index.md | 112 ++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md new file mode 100644 index 00000000000000..52342d852cb37b --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md @@ -0,0 +1,112 @@ +--- +title: action +slug: Mozilla/Add-ons/WebExtensions/API/action +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +读取并修改使用 [`action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器工具栏按钮的属性，并监听点击事件。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高版本中可用。它替代了 Manifest V2 API {{WebExtAPIRef("browserAction")}}，以及在 Chrome、Safari 中的 {{WebExtAPIRef("pageAction")}}。 + +[浏览器操作](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Toolbar_button)是浏览器工具栏中的一个按钮。 + +你可以将弹窗与按钮关联。与网页一样，弹窗使用 HTML、CSS 和 JavaScript 指定。在弹窗中运行的 JavaScript 可以访问与后台脚本相同的 WebExtension API，但其全局上下文是弹窗，而不是浏览器中显示的当前页面。要影响网页，你需要通过[消息](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page#messaging)与它们通信。 + +如果指定了弹窗，当用户点击图标时，它会显示 — 并加载内容。如果没有指定弹窗，当用户点击图标时，会向你的扩展发送一个事件。 + +按钮还有一个上下文菜单，你可以使用 `action` {{WebExtAPIRef("menus.ContextType")}} API 使用 `action` API 添加项目到这个菜单。 + +使用 `action` API，你可以： + +- 使用 {{WebExtAPIRef("action.onClicked")}} 监听图标的点击事件。 +- 获取和设置图标的属性（图标、标题、弹窗等）。你可以全局获取和设置这些属性，跨所有标签页，或者通过传递标签页 id 作为额外参数来为标签页设置。 + +## 类型 + +- {{WebExtAPIRef("action.ColorArray")}} + - : 四个范围在 0-255 间的整型的数组，表示一个颜色。 +- {{WebExtAPIRef("action.ImageDataType")}} + - : 图片的像素数据，必须是一个 [`ImageData`](/zh-CN/docs/Web/API/ImageData) 对象（如来源于一个 {{htmlelement("canvas")}} 元素）。 + +## 函数 + +- {{WebExtAPIRef("action.setTitle()")}} + - : 设置浏览器操作的标题。标题显示在鼠标悬停在浏览器操作图标上时的工具提示中。 +- {{WebExtAPIRef("action.getTitle()")}} + - : 获取浏览器操作的标题。 +- {{WebExtAPIRef("action.setIcon()")}} + - : 设置浏览器操作的图标。 +- {{WebExtAPIRef("action.setPopup()")}} + - : 设置用户单击浏览器操作图标时打开的 HTML 文档。 +- {{WebExtAPIRef("action.getPopup()")}} + - : 设置用户单击浏览器操作图标时打开的 HTML 文档。 +- {{WebExtAPIRef("action.openPopup()")}} + - : 打开浏览器操作的弹窗。 +- {{WebExtAPIRef("action.setBadgeText()")}} + - : 设置浏览器操作的徽标文本（徽标将显示在图标上方）。 +- {{WebExtAPIRef("action.getBadgeText()")}} + - : 获取浏览器操作的徽标文本。 +- {{WebExtAPIRef("action.setBadgeBackgroundColor()")}} + - : 设置徽标的背景颜色。 +- {{WebExtAPIRef("action.getBadgeBackgroundColor()")}} + - : 获取徽标的背景颜色。 +- {{WebExtAPIRef("action.setBadgeTextColor()")}} + - : 设置徽标的文本颜色。 +- {{WebExtAPIRef("action.getBadgeTextColor()")}} + - : 获取徽标的文本颜色。 +- {{WebExtAPIRef("action.getUserSettings()")}} + - : 获取浏览器操作的用户设置。 +- {{WebExtAPIRef("action.enable()")}} + - : 启用某一个标签页的浏览器操作。默认情况下，所有标签页的浏览器操作都是启用的。 +- {{WebExtAPIRef("action.disable()")}} + - : 禁用某一个标签页的浏览器操作，意味着当该标签页处于活动状态时浏览器操作将无法被点击。 +- {{WebExtAPIRef("action.isEnabled()")}} + - : 检查浏览器操作是否被启用。 + +## Events + +- {{WebExtAPIRef("action.onClicked")}} + - : 当浏览器操作图标被点击时触发。当浏览器操作有弹窗时该事件不会触发。 + +{{WebExtExamples("h2")}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/) API。该文档衍生于 Chromium 代码中的 [`action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/action.json)。 + + From 32a8283cdb4b355cb97d4a3bf461c786304f4fe1 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 17:30:29 +0800 Subject: [PATCH 2/5] feat: update translation Co-authored-by: A1lo --- .../add-ons/webextensions/api/action/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md index 52342d852cb37b..de1e38c3a3e496 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md @@ -7,28 +7,28 @@ l10n: {{AddonSidebar}} -读取并修改使用 [`action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器工具栏按钮的属性，并监听点击事件。 +读取并修改使用 [`action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器工具栏按钮的属性，并监听按钮的点击事件。 > [!NOTE] > 该 API 在 Manifest V3 或更高版本中可用。它替代了 Manifest V2 API {{WebExtAPIRef("browserAction")}}，以及在 Chrome、Safari 中的 {{WebExtAPIRef("pageAction")}}。 [浏览器操作](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/user_interface/Toolbar_button)是浏览器工具栏中的一个按钮。 -你可以将弹窗与按钮关联。与网页一样，弹窗使用 HTML、CSS 和 JavaScript 指定。在弹窗中运行的 JavaScript 可以访问与后台脚本相同的 WebExtension API，但其全局上下文是弹窗，而不是浏览器中显示的当前页面。要影响网页，你需要通过[消息](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page#messaging)与它们通信。 +你可以将弹窗与按钮关联。与网页一样，弹窗使用 HTML、CSS 和 JavaScript 指定。在弹窗中运行的 JavaScript 可以访问与后台脚本相同的 WebExtension API，但其全局上下文是弹窗，而不是浏览器中显示的当前页面。要影响网页，你需要通过[消息](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page#消息)与网页进行通信。 -如果指定了弹窗，当用户点击图标时，它会显示 — 并加载内容。如果没有指定弹窗，当用户点击图标时，会向你的扩展发送一个事件。 +如果指定了弹窗，当用户点击图标时，它会显示并加载内容。如果没有指定弹窗，当用户点击图标时，会向你的扩展发送一个事件。 -按钮还有一个上下文菜单，你可以使用 `action` {{WebExtAPIRef("menus.ContextType")}} API 使用 `action` API 添加项目到这个菜单。 +按钮还有一个上下文菜单。你可以利用 {{WebExtAPIRef("menus")}} API 中 `action` 的 {{WebExtAPIRef("menus.ContextType")}} 添加上下文菜单项。 使用 `action` API，你可以： - 使用 {{WebExtAPIRef("action.onClicked")}} 监听图标的点击事件。 -- 获取和设置图标的属性（图标、标题、弹窗等）。你可以全局获取和设置这些属性，跨所有标签页，或者通过传递标签页 id 作为额外参数来为标签页设置。 +- 获取和设置图标的属性（图标、标题、弹窗等）。你可以全局（对所有标签页）获取和设置这些属性，也可以通过传递标签页 id 作为额外参数来为某个标签页获取和设置这些属性。 ## 类型 - {{WebExtAPIRef("action.ColorArray")}} - - : 四个范围在 0-255 间的整型的数组，表示一个颜色。 + - : 四个范围在 0-255 间的整型组成的数组，表示一个颜色。 - {{WebExtAPIRef("action.ImageDataType")}} - : 图片的像素数据，必须是一个 [`ImageData`](/zh-CN/docs/Web/API/ImageData) 对象（如来源于一个 {{htmlelement("canvas")}} 元素）。 @@ -67,7 +67,7 @@ l10n: - {{WebExtAPIRef("action.isEnabled()")}} - : 检查浏览器操作是否被启用。 -## Events +## 事件 - {{WebExtAPIRef("action.onClicked")}} - : 当浏览器操作图标被点击时触发。当浏览器操作有弹窗时该事件不会触发。 From a6caf4f58dd5323e47aa0342251f820e0807ea09 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 7 Aug 2024 17:49:27 +0800 Subject: [PATCH 3/5] fix: format --- files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md index de1e38c3a3e496..6123e9ba380eb7 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md @@ -18,7 +18,7 @@ l10n: 如果指定了弹窗，当用户点击图标时，它会显示并加载内容。如果没有指定弹窗，当用户点击图标时，会向你的扩展发送一个事件。 -按钮还有一个上下文菜单。你可以利用 {{WebExtAPIRef("menus")}} API 中 `action` 的 {{WebExtAPIRef("menus.ContextType")}} 添加上下文菜单项。 +按钮还有一个上下文菜单。你可以利用 {{WebExtAPIRef("menus")}} API 中 `action` 的 {{WebExtAPIRef("menus.ContextType")}} 添加上下文菜单项。 使用 `action` API，你可以： From 24d7617a96cdca779f1d7fcb57cc0e7cc24c51ea Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 8 Aug 2024 10:47:48 +0800 Subject: [PATCH 4/5] feat: update translation Co-authored-by: A1lo --- .../add-ons/webextensions/api/action/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md index 6123e9ba380eb7..37ba2cc04bcc5c 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md @@ -7,7 +7,7 @@ l10n: {{AddonSidebar}} -读取并修改使用 [`action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器工具栏按钮的属性，并监听按钮的点击事件。 +用于读取和修改使用 [`action`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action) 清单键定义的浏览器工具栏按钮的属性，以及监听按钮的点击事件。 > [!NOTE] > 该 API 在 Manifest V3 或更高版本中可用。它替代了 Manifest V2 API {{WebExtAPIRef("browserAction")}}，以及在 Chrome、Safari 中的 {{WebExtAPIRef("pageAction")}}。 @@ -23,27 +23,27 @@ l10n: 使用 `action` API，你可以： - 使用 {{WebExtAPIRef("action.onClicked")}} 监听图标的点击事件。 -- 获取和设置图标的属性（图标、标题、弹窗等）。你可以全局（对所有标签页）获取和设置这些属性，也可以通过传递标签页 id 作为额外参数来为某个标签页获取和设置这些属性。 +- 获取和设置图标的属性（图标、标题、弹窗等）。你可以全局地（对所有标签页而言）获取和设置这些属性，也可以通过传递标签页 id 作为额外参数来对某个标签页单独获取和设置这些属性。 ## 类型 - {{WebExtAPIRef("action.ColorArray")}} - - : 四个范围在 0-255 间的整型组成的数组，表示一个颜色。 + - : 四个范围在 0-255 间的整型组成的数组，表示一个 RGBA 颜色。 - {{WebExtAPIRef("action.ImageDataType")}} - : 图片的像素数据，必须是一个 [`ImageData`](/zh-CN/docs/Web/API/ImageData) 对象（如来源于一个 {{htmlelement("canvas")}} 元素）。 ## 函数 - {{WebExtAPIRef("action.setTitle()")}} - - : 设置浏览器操作的标题。标题显示在鼠标悬停在浏览器操作图标上时的工具提示中。 + - : 设置浏览器操作的标题。这会在工具提示中显示出来。 - {{WebExtAPIRef("action.getTitle()")}} - : 获取浏览器操作的标题。 - {{WebExtAPIRef("action.setIcon()")}} - : 设置浏览器操作的图标。 - {{WebExtAPIRef("action.setPopup()")}} - - : 设置用户单击浏览器操作图标时打开的 HTML 文档。 + - : 设置用户单击浏览器操作图标时打开的弹窗所用的 HTML 文档。 - {{WebExtAPIRef("action.getPopup()")}} - - : 设置用户单击浏览器操作图标时打开的 HTML 文档。 + - : 设置用户单击浏览器操作图标时打开的弹窗所用的 HTML 文档。 - {{WebExtAPIRef("action.openPopup()")}} - : 打开浏览器操作的弹窗。 - {{WebExtAPIRef("action.setBadgeText()")}} @@ -79,7 +79,7 @@ l10n: {{Compat}} > [!NOTE] -> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/) API。该文档衍生于 Chromium 代码中的 [`action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/action.json)。 +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/) API。该文档衍生自 Chromium 代码中的 [`action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/action.json)。