页面操作
读取和修改使用 page_action
清单密钥定义的地址栏按钮的属性,并监听其点击事件。
地址栏按钮 是添加到浏览器地址栏的按钮。
您可以在后台脚本中监听图标的点击事件,或者指定一个 弹出窗口,当单击图标时打开。
如果您指定弹出窗口,则可以使用 HTML、CSS 和 JavaScript 定义其内容和行为。在弹出窗口中运行的 JavaScript 可以访问与您的后台脚本相同的 WebExtension API。尽管名为 pageAction
,但操作代码无法访问网页内容。要访问网页 DOM,您需要添加 内容脚本 并与之交互。
该按钮还有一个上下文菜单,您可以使用 menus
API 通过 page_action
menus.ContextType
向此菜单添加项目。
页面操作适用于仅与特定页面相关的操作(例如“将当前标签页添加书签”)。如果它们与整个浏览器相关(例如“显示所有书签”),请改用 浏览器操作。
类型
pageAction.ImageDataType
-
图像的像素数据。
函数
pageAction.show()
-
显示给定标签页的页面操作。
pageAction.hide()
-
隐藏给定标签页的页面操作。
pageAction.isShown()
-
检查页面操作是否显示。
pageAction.setTitle()
-
设置页面操作的标题。这将显示在页面操作上的工具提示中。
pageAction.getTitle()
-
获取页面操作的标题。
pageAction.setIcon()
-
设置页面操作的图标。
pageAction.setPopup()
-
设置页面操作弹出窗口的 URL。
pageAction.getPopup()
-
获取页面操作弹出窗口的 URL。
pageAction.openPopup()
-
打开页面操作的弹出窗口。
事件
pageAction.onClicked
-
单击页面操作图标时触发。如果页面操作有弹出窗口,则不会触发此事件。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例扩展
注意:此 API 基于 Chromium 的 chrome.pageAction
API。此文档来自 Chromium 代码中的 page_action.json
。