pageAction

读取和修改通过 page_action manifest 键定义的地址栏按钮的属性,并监听其点击事件。

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

Paw print icon representing a page action

你可以在后台脚本中监听图标点击事件,或者指定一个在图标被点击时打开的 弹出窗口

如果你指定了一个弹出窗口,你可以使用 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