browserAction

ブラウザーのツールバーにボタンを追加します。

ブラウザーアクション (en-US)はブラウザーのツールバー内のボタンです。

これをボタンつきポップアップと関連付けられます。ポップアップは通常のウェブページ同様に、HTML, CSS, JavaScript を使って指定できます。ポップアップの中で動く JavaScript はバックグラウンドスクリプトとすべて同じ WebExtension API にアクセスできますが、グローバルコンテキストはブラウザーに表示される現在のページではなく、ポップアップになります。ウェブページに影響するには messages 経由で通信する必要があります。

ユーザーがアイコンをクリックした時に、ポップアップを指定していると、表示され — そしてコンテンツが読み込まれるでしょう。ポップアップを指定していない時は、ユーザーがアイコンをクリックした時、拡張機能にイベントがディスパッチされます。

たいていのブラウザーアクションのプロパティは、manifest.json 内の browser_action キーを用いて宣言的に定義できます。

browserAction API では、次が可能です:

browserAction.onClicked を使ってアイコンのクリックをリッスンする
アイコンのプロパティ — アイコン、タイトル、ポップアップなど、の取得、設定。これはすべてのタブを通してグローバルにも、またはタブの ID を追加引数で渡すことで特定のタブだけにも取得、設定できます。

型

browserAction.ColorArray: RGBA 色を決める 0-255 の範囲の4整数の配列
browserAction.ImageDataType (en-US): 画像のピクセルデータ。ImageData オブジェクト (例えば <canvas> 要素から) でないといけない。

関数

browserAction.setTitle() (en-US): ブラウザーアクションのタイトルをセットする。ツールチップに表示される。
browserAction.getTitle() (en-US): ブラウザーアクションのタイトルを取得します。
browserAction.setIcon() (en-US): ブラウザーアクションのアイコンをセットします。
browserAction.setPopup() (en-US): ユーザーがブラウザーアクションのアイコンをクリックした時に表示されるポップアップの HTML 文書をセットします。
browserAction.getPopup() (en-US): ブラウザーアクションのポップアップとしてセットされた HTML 文書を取得します。
browserAction.openPopup() (en-US): ブラウザーアクションのポップアップを開きます。
browserAction.setBadgeText() (en-US): ブラウザーアクションのバッジテキストをセットします。バッジはアイコンの上部に表示されます。
browserAction.getBadgeText() (en-US): ブラウザーアクションのバッジのテキストを取得します。
browserAction.setBadgeBackgroundColor() (en-US): バッジの背景色を指定します。
browserAction.getBadgeBackgroundColor() (en-US): バッジの背景色を取得します。
browserAction.enable() (en-US): タブのブラウザーアクションを有効にします。既定では、ブラウザーアクションはすべてのタブで有効です。
browserAction.disable(): タブのブラウザーアクションを無効にします。つまりタブがアクティブでもクリックできません。
browserAction.isEnabled() (en-US): ブラウザーアクションが有効か否かをチェックします。

イベント

browserAction.onClicked: ブラウザーアクションがクリックされた時に発火します。このイベントはブラウザーアクションがポップアップ付きでない場合は発火しません。

ブラウザ実装状況

BCD tables only load in the browser

Example extensions

謝辞

この API は Chromium の chrome.browserAction API に基づいています。この文書は Chromium コードの browser_action.json から得ています。

Microsoft Edge の実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。