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

型

+ +

RGBA色を定義する、4つの0から255の整数の配列です。4つの値は以下のチャネルを指定します:

+ +
    +
  1. 赤(Red)
    2. +
  2. 緑(Green)
    3. +
  3. 青(Blue)
    4. +
  4. アルファ(Alpha) (不透明度)
    5. +
+ +

たとえば、不透明な赤は[255, 0, 0, 255]です。

+ +

ブラウザ互換性

+ + + +

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

+ +

{{WebExtExamples}}

+ +
謝辞 + +

このAPIはChromiumのchrome.browserAction APIに基づいています。このドキュメントはChromiumコードの browser_action.jsonから派生したものです。

+ +

 

+ +

Microsoft Edgeの互換性データはMicrosoft Corporationから提供されており、Creative Commons Attribution 3.0 United States Licenseのもとにここに含まれています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/browseraction/disable/index.html b/files/ja/mozilla/add-ons/webextensions/api/browseraction/disable/index.html new file mode 100644 index 0000000000..5eb7c5f3c4 --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/browseraction/disable/index.html @@ -0,0 +1,87 @@ +--- +title: browserAction.disable() +slug: Mozilla/Add-ons/WebExtensions/API/browserAction/disable +translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/disable +--- +
{{AddonSidebar()}}
+ +

タブに対してブラウザアクションを無効にします。つまり、タブがアクティブな時クリックされなくなります。

+ +

書式

+ +
browser.browserAction.disable(
+  tabId // optional integer
+)
+
+ +

パラメータ

+ +
+
tabId{{optional_inline}}
+
integer. ブラウザアクションを無効にしたいタブのIDです。
+
+ +

ブラウザ互換性

+ + + +

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

+ +

例

+ +

クリックされたときブラウザアクションを無効にし、新しいタブが開かれる毎回再度有効にします:

+ +
browser.tabs.onCreated.addListener(() => {
+  browser.browserAction.enable();
+});
+
+browser.browserAction.onClicked.addListener(() => {
+  browser.browserAction.disable();
+});
+
+ +

アクティブなタブにだけブラウザアクションを無効にします:

+ +
browser.browserAction.onClicked.addListener((tab) => {
+  browser.browserAction.disable(tab.id);
+});
+ +

{{WebExtExamples}}

+ +
Acknowledgements + +

This API is based on Chromium's chrome.browserAction API. This documentation is derived from browser_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.

+
+ + 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 に従っています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html b/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html new file mode 100644 index 0000000000..46f3a666a7 --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.html @@ -0,0 +1,102 @@ +--- +title: browserAction.onClicked +slug: Mozilla/Add-ons/WebExtensions/API/browserAction/onClicked +translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/onClicked +--- +
{{AddonSidebar()}}
+ +

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

+ +

右クリックを定義するには、contextMenus API の"browser_action" context typeを利用してください。

+ +

書式

+ +
browser.browserAction.onClicked.addListener(listener)
+browser.browserAction.onClicked.removeListener(listener)
+browser.browserAction.onClicked.hasListener(listener)
+
+ +

イベントは３つの関数を持っています:

+ +
+
addListener(listener)
+
このイベントのリスナーを追加します。
+
removeListener(listener)
+
このイベントのリスニングを停止します。引数listenerは削除するリスナーです。
+
hasListener(listener)
+
listenerがこのイベントに登録されているかどうかを調べます。trueが返ればリスニング中です。falseが返ればそうれはありません。
+
+ +

addListenerの書式

+ +

パラメータ

+ +
+
callback
+
+

イベントが発生したときに呼び出される関数です。関数は以下の引数を渡されます:

+ +
+
tab
+
{{WebExtAPIRef('tabs.Tab')}}. アイコンがクリックされたときにアクティブなタブです。
+
+
+
+ +

ブラウザ互換性

+ + + +

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

+ +

例

+ +

ユーザがアイコンをクリックすると、アクティブなタブではアイコンを無効にし、タブのURLをログします:

+ +
browser.browserAction.onClicked.addListener((tab) => {
+  // disable the active tab
+  browser.browserAction.disable(tab.id);
+  // requires the "tabs" or "activeTab" permission
+  console.log(tab.url);
+});
+
+ +

{{WebExtExamples}}

+ +
謝辞 + +

この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