browserAction

读取和修改属性,并侦听使用 browser_action 清单键定义的浏览器工具栏按钮上的点击事件。

一个 浏览器操作 是浏览器工具栏中的一个按钮。

您可以将弹出窗口与按钮关联。与网页一样,弹出窗口使用 HTML、CSS 和 JavaScript 指定。在弹出窗口中运行的 JavaScript 可以访问与后台脚本相同的 WebExtension API,但其全局上下文是弹出窗口,而不是浏览器中显示的当前页面。要影响网页,您需要通过 消息 与它们进行通信。

如果指定了弹出窗口,则在用户单击图标时显示弹出窗口(并加载内容)。如果不指定弹出窗口,则在用户单击图标时会向您的扩展程序分派一个事件。

该按钮还有一个上下文菜单,您可以使用 menus API 和 browser_action menus.ContextType 向此菜单添加项目。

使用 browserAction API,您可以

  • 使用 browserAction.onClicked 侦听图标上的点击事件。
  • 获取和设置图标的属性 - 图标、标题、弹出窗口等。您可以全局获取和设置这些属性,也可以通过传递选项卡 ID 作为附加参数来为特定选项卡获取和设置这些属性。

类型

browserAction.ColorArray

一个包含 0-255 范围内的四个整数的数组,定义 RGBA 颜色。

browserAction.ImageDataType

图像的像素数据。必须是 ImageData 对象(例如,来自 <canvas> 元素)。

函数

browserAction.setTitle()

设置浏览器操作的标题。这将显示在工具提示中。

browserAction.getTitle()

获取浏览器操作的标题。

browserAction.setIcon()

设置浏览器操作的图标。

browserAction.setPopup()

设置在用户单击浏览器操作图标时打开的 HTML 文档作为弹出窗口。

browserAction.getPopup()

获取设置为浏览器操作弹出窗口的 HTML 文档。

browserAction.openPopup()

打开浏览器操作的弹出窗口。

browserAction.setBadgeText()

设置浏览器操作的徽章文本。徽章显示在图标顶部。

browserAction.getBadgeText()

获取浏览器操作的徽章文本。

browserAction.setBadgeBackgroundColor()

设置徽章的背景颜色。

browserAction.getBadgeBackgroundColor()

获取徽章的背景颜色。

browserAction.setBadgeTextColor()

设置徽章的文本颜色。

browserAction.getBadgeTextColor()

获取徽章的文本颜色。

browserAction.getUserSettings()

获取浏览器操作的用户指定设置。

browserAction.enable()

为选项卡启用浏览器操作。默认情况下,浏览器操作对所有选项卡都启用。

browserAction.disable()

禁用选项卡的浏览器操作,这意味着当该选项卡处于活动状态时无法单击它。

browserAction.isEnabled()

检查浏览器操作是否已启用。

事件

browserAction.onClicked

单击浏览器操作图标时触发。如果浏览器操作具有弹出窗口,则此事件不会触发。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例扩展