ページアクションのアイコンがクリックされたときに発火します。ページアクションがポップアップを持っているならこのイベントは発火しません。
右クリックのアクションを定義するには、contextMenus
APIを"page_action" context typeとともに使ってください。
書式
browser.pageAction.onClicked.addListener(listener)
browser.pageAction.onClicked.removeListener(listener)
browser.pageAction.onClicked.hasListener(listener)
イベントは3つの関数を持ちます:
addListener(callback)
- このイベントにリスナーを追加します。Adds a listener to this event.
removeListener(listener)
- このイベントのリスニングを停止します。引数
listener
は削除するリスナーです。 hasListener(listener)
listener
がイベントに登録されているかを調べます。リスニング中であればtrue
を、そうれなければfalse
を返します。
addListenerの書式
パラメータ
callback
-
イベント発生時に呼び出される関数です。関数は次の引数を渡されます:
tab
- ページアクションがクリックされたタブの
tabs.Tab
オブジェクト。
ブラウザ互換性
BCD tables only load in the browser
The compatibility table in 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.
例
ユーザがページアクションをクリックしたとき、それを隠し、アクティブタブを"http://chilloutandwatchsomecatgifs.com/"に誘導します:
var CATGIFS = "http://chilloutandwatchsomecatgifs.com/";
browser.pageAction.onClicked.addListener((tab) => {
browser.pageAction.hide(tab.id);
browser.tabs.update({url: CATGIFS});
});
browser.pageAction.onClicked.addListener(function () {
});
Example extensions
This API is based on Chromium's chrome.pageAction
API. This documentation is derived from page_action.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.