pageAction.onClicked
当页面操作图标被点击时触发。如果页面操作带有弹出窗口,此事件将不会触发。
要定义右键单击操作,请使用带有“page_action”上下文类型的contextMenus API。
语法
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 语法
参数
监听器-
此事件发生时调用的函数。该函数会传递以下参数:
tab-
一个代表页面操作被点击的选项卡 的
tabs.Tab对象。 OnClickData-
包含有关单击事件信息的对象。
modifiers-
一个
数组。单击时处于激活状态的键盘修饰键,可以是一个或多个:Shift、Alt、Command、Ctrl或MacCtrl。 -
一个
整数。指示用于单击页面操作图标的按钮:0表示左键单击或与鼠标无关的单击(例如来自键盘的单击),1表示中键或滚轮单击。请注意,不支持右键单击,因为 Firefox 在触发此事件之前会消耗该单击以显示上下文菜单。
示例
当用户点击页面操作时,隐藏它,并将活动选项卡导航到“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。