页面操作

读取和修改使用 page_action 清单密钥定义的地址栏按钮的属性,并监听其点击事件。

地址栏按钮 是添加到浏览器地址栏的按钮。

Paw print icon representing a 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