pageAction.onClicked
当页面操作图标被点击时触发。如果页面操作有弹出窗口,此事件将不会触发。
要定义右键单击操作,请使用 contextMenus
API,并使用 "page_action" 上下文类型.
语法
js
browser.pageAction.onClicked.addListener(listener)
browser.pageAction.onClicked.removeListener(listener)
browser.pageAction.onClicked.hasListener(listener)
事件有三个函数
addListener(listener)
-
为该事件添加监听器。
removeListener(listener)
-
停止监听该事件。
listener
参数是要删除的监听器。 hasListener(listener)
-
检查是否为该事件注册了
listener
。如果正在监听,则返回true
,否则返回false
。
addListener 语法
参数
listener
-
当该事件发生时调用的函数。该函数将传递以下参数
tab
-
一个
tabs.Tab
对象,表示页面操作被点击的选项卡。 OnClickData
-
一个包含关于点击信息的 对象。
modifiers
-
一个
array
。点击时活动的键盘修饰键,可以是以下修饰键中的一个或多个:Shift
、Alt
、Command
、Ctrl
或MacCtrl
。 -
一个
integer
。指示用于点击页面操作图标的按钮:0
表示左键点击或与鼠标无关的点击,例如键盘点击;1
表示中间按钮或滚轮点击。请注意,右键点击不受支持,因为 Firefox 会在触发此事件之前消耗该点击以显示上下文菜单。
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
示例
当用户点击页面操作时,隐藏它,并将活动选项卡导航到 "https://giphy.com/explore/cat"
js
let CATGIFS = "https://giphy.com/explore/cat";
browser.pageAction.onClicked.addListener((tab) => {
browser.pageAction.hide(tab.id);
browser.tabs.update({ url: CATGIFS });
});
browser.pageAction.onClicked.addListener(() => {});
示例扩展
注意:此 API 基于 Chromium 的 chrome.pageAction
API。此文档源自 Chromium 代码中的 page_action.json
。