menus.onClicked
メニューアイテムがクリックされたときに発火します。
他のブラウザとの互換性のためにFirefoxはこのイベントを名前空間contextMenus
とmenu
を経由して利用可能にしています。
書式
browser.menus.onClicked.addListener(listener)
browser.menus.onClicked.removeListener(listener)
browser.menus.onClicked.hasListener(listener)
イベントは3つの関数を持ちます:
addListener(callback)
- このイベントのリスナーを追加します。
removeListener(listener)
- リスニングを停止します。引数
listener
は削除するリスナーです。 hasListener(listener)
listener
が登録されているかどうかを調べます。true
が返ればリスニング中、そうでなければfalse
が返ります。
addListenerの書式
パラメータ
callback
-
イベントが起こったときに呼ばれる関数です。以下の引数を渡されます:
info
- menus.OnClickData (en-US). Information about the item clicked and the context where the click happened.
tab
tabs.Tab
. The details of the tab where the click took place. If the click did not take place in or on a tab, this parameter will be missing.
ブラウザ互換性
BCD tables only load in the browser
例
この例はメニューアイテムのクリックをリッスンし、アイテムのIDとタブのIDをログします:
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);
});
Example extensions
Acknowledgements
This API is based on Chromium's chrome.contextMenus
API. This documentation is derived from context_menus.json
in the Chromium code.