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

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

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

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

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

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

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

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

関数

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

イベント

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

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
ColorArray 有り 有り45 無し 有り
ImageDataType 有り 有り45 無し 有り
disable 有り 有り45 無し 有り
enable 有り 有り45 無し 有り
getBadgeBackgroundColor 有り 有り45 無し 有り
getBadgeText 有り 有り45 無し 有り
getPopup 有り 無し4557 有り
getTitle 有り154555 有り
onClicked 有り 有り4555 有り
openPopup 無し 無し57 無し 無し
setBadgeBackgroundColor 有り * 有り *45 * 無し 有り *
setBadgeText 有り * 有り *45 * 無し 有り *
setIcon 有り * 有り *45 * 無し15 *
setPopup 有り * 有り *45 *57 * 有り *
setTitle 有り *15 *45 *55 * 有り *

Example extensions

謝辞

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

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

ドキュメントのタグと貢献者

 このページの貢献者: Uemmra3
 最終更新者: Uemmra3,