pageAction
读取和修改通过 page_action manifest 键定义的地址栏按钮的属性,并监听其点击事件。
地址栏按钮是添加到浏览器地址栏的一个按钮。

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