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
函数
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 的浏览器中加载。