From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../webextensions/api/browseraction/index.html | 116 +++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.html (limited to 'files/zh-cn/mozilla/add-ons/webextensions/api/browseraction') diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.html b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.html new file mode 100644 index 0000000000..2d49dff094 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.html @@ -0,0 +1,116 @@ +--- +title: browserAction +slug: Mozilla/Add-ons/WebExtensions/API/browserAction +translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction +--- +
{{AddonSidebar}}
+ +

添加按钮到浏览器的工具栏。

+ +

您可以为该按钮指派一个弹出窗。弹出窗可采用 HTML、CSS 和 JavaScript 编写，就像是一个普通的网页。运行在该弹出窗中的 JavaScript 可以同您的后台脚本一样访问所有的 WebExtension API，但它的全局上下文是该弹出窗，而不是浏览器中的当前页面。要影响网页，您需要通过消息通信。

+ +

如果您指定了弹出窗，它将显示——内容将在用户点击该图标时被加载。如果您没有指定一个弹出窗，用户单击该图标的事件将派发到您的扩展。

+ +

您可以用 manifest.json 中的 browser_action 键值声明定义大多数浏览器动作属性。

+ +

使用 browserAction API，您可以：

+ + + +

另见用户界面组件中的浏览器动作章节。

+ +

类型

+ +
+
{{WebExtAPIRef("browserAction.ColorArray")}}
+
0-255范围内的四个整数的数组，定义RGBA颜色。
+
{{WebExtAPIRef("browserAction.ImageDataType")}}
+
一个图像的像素数据。必须为一个 ImageData 对象（例如，来自一个 {{htmlelement("canvas")}} 元素）。
+
+ +

函数

+ +
+
{{WebExtAPIRef("browserAction.setTitle()")}}
+
设置浏览器动作的标题。这将在工具提示（鼠标悬停时）显示。
+
{{WebExtAPIRef("browserAction.getTitle()")}}
+
获取浏览器动作的标题。
+
{{WebExtAPIRef("browserAction.setIcon()")}}
+
设置浏览器动作的图标。
+
{{WebExtAPIRef("browserAction.setPopup()")}}
+
设置 HTML 文档作为浏览器动作图标被用户点击时显示的弹出窗。
+
{{WebExtAPIRef("browserAction.getPopup()")}}
+
获取作为浏览器动作的弹出窗的 HTML 文档。
+
{{WebExtAPIRef("browserAction.setBadgeText()")}}
+
设置浏览器动作的徽章文本。该徽章显示在图标上方。
+
{{WebExtAPIRef("browserAction.getBadgeText()")}}
+
获取浏览器动作的徽章文本。
+
{{WebExtAPIRef("browserAction.setBadgeBackgroundColor()")}}
+
设置徽章的后台颜色。
+
{{WebExtAPIRef("browserAction.getBadgeBackgroundColor()")}}
+
获取徽章的后台颜色。
+
{{WebExtAPIRef("browserAction.enable()")}}
+
为一个标签页启用浏览器动作。默认情况下，浏览器动作为所有标签页启用。
+
{{WebExtAPIRef("browserAction.disable()")}}
+
为一个标签页禁用浏览器动作，使该标签页为活动时无法单击它。
+
+ +

事件

+ +
+
{{WebExtAPIRef("browserAction.onClicked")}}
+
在浏览器动作图标点击时被触发。如果浏览器动作有弹出窗，则该事件不会触发。
+
+ +

浏览器兼容性

+ +

{{Compat("webextensions.api.browserAction")}}

+ + + +

{{WebExtExamples("h2")}}

+ +
致谢 + +

此 API 基于 Chromium 的 chrome.browserAction API。此文档派生自 Chromium 代码中的 browser_action.json。

+ +

Microsoft Edge 兼容性数据由微软公司提供，并以 知识共享 署名 3.0 美国版 许可。

+
+ + -- cgit v1.2.3-54-g00ecf