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。点击时活动的键盘修饰键,可以是以下修饰键中的一个或多个:ShiftAltCommandCtrlMacCtrl

button

一个 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