From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../webextensions/api/browseraction/index.html | 129 +++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html (limited to 'files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html') diff --git a/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html b/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html new file mode 100644 index 0000000000..f5291179ee --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/browseraction/index.html @@ -0,0 +1,129 @@ +--- +title: browserAction +slug: Mozilla/Add-ons/WebExtensions/API/browserAction +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - WebExtensions + - browserAction +translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction +--- +
{{AddonSidebar}}
+ +

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

+ +

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

+ +

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

+ +

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

+ +

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

+ +

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

+ + + +

型

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

関数

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

イベント

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

ブラウザ実装状況

+ +

{{Compat("webextensions.api.browserAction")}}

+ + + +

{{WebExtExamples("h2")}}

+ +
謝辞 + +

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

+ +

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

+
+ + -- cgit v1.2.3-54-g00ecf