menus.onClicked

點選選單項時觸發。

為了相容其他瀏覽器,Firefox 透過 contextMenus 名稱空間以及 menus 名稱空間都提供了此事件。

語法

js
browser.menus.onClicked.addListener(listener)
browser.menus.onClicked.removeListener(listener)
browser.menus.onClicked.hasListener(listener)

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查 listener 是否已為此事件註冊。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

此事件發生時呼叫的函式。該函式會傳遞以下引數:

info

menus.OnClickData。有關被點選的選單項以及點擊發生上下文的資訊。

tab

tabs.Tab。發生點選的標籤頁的詳細資訊。如果點選未發生在標籤頁內或標籤頁上,此引數將缺失。

示例

此示例偵聽選單項的點選事件,然後記錄選單項的 ID 和標籤頁的 ID。

js
browser.menus.create({
  id: "click-me",
  title: "Click me!",
  contexts: ["all"],
});

browser.menus.onClicked.addListener((info, tab) => {
  console.log(`Item ${info.menuItemId} clicked in tab ${tab.id}`);
});

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.contextMenus API。本文件源自 Chromium 程式碼中的 context_menus.json