pageAction.onClicked
语法
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 在触发此事件之前会消耗右键单击以显示上下文菜单。
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
onClicked | |||||||
OnClickData | |||||||
tab |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
示例
以下示例演示了如何在用户单击页面操作时隐藏该页面操作,并将活动标签页导航到“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
。