pageAction.onClicked

ページアクションのアイコンがクリックされたときに発火します。ページアクションがポップアップを持っているならこのイベントは発火しません。

右クリックのアクションを定義するには、contextMenus API を"page_action" context type#とともに使ってください。

書式

js
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

例

ユーザーがページアクションをクリックしたとき、それを隠し、アクティブタブを"http://chilloutandwatchsomecatgifs.com/"に誘導します:

js
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.