此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

pageAction

读取和修改使用 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

当页面操作图标被点击时触发。如果页面操作有弹窗,则该事件将不会被触发。

浏览器兼容性

示例扩展

备注:此 API 基于 Chromium 的 chrome.pageAction API。该文档衍生自 Chromium 代码中的 page_action.json。