Screw-Axis::doc

Chrome Extensions API リファレンス

ページアクション

ページアクションのアイコンは、アドレスバー内の右端に表示される。現在選択されているページに対する機能を提供するもので、全てのページを対象にしたものではない。例えば、以下のようなものがページアクションにあたる。

• 現在のページのRSS購読機能
• 現在のページで使われている画像のスライドショー

もし拡張機能のアイコンを常に表示した状態にしたいのであれば、ブラウザアクションを使う。

Manifest

Manifest Fileへのページアクションの設定は、次のように記述する。

{
  "name": "MyExtension",
  ...
  "page_action": {
    "default_icon": "icon.png",    // 必須
    "default_title": "Do action",  // オプション: ツールチップ
    "default_popup": "popup.html"  // オプション: ポップアップページ
  }
  ...
}

ユーザインターフェース

ページアクションはブラウザアクション同様にアイコン、ツールチップ、ポップアップなどを持つが、バッジは存在しない。そしてページアクションは、現在表示されているページによって、アイコンの表示/非表示を行うことができる。アイコン、ツールチップ、ポップアップなどが指すものについては、ブラウザアクションを参照されたい。

アイコンの表示制御には、pageAction.showとpageAction.hideを使う。初期設定ではアイコンは非表示となっている。これを表示させたい場合、対象となるタブのIDを指定する。アイコンはタブが閉じられたり、ユーザの操作などによって異なるURLへ移るまで、表示され続ける。

Tips

• ページアクションは、限られたページのみに適用される機能に用いるべき。
• ほとんどのページで使われる機能であれば、ブラウザアクションを用いるべき。
• アイコンは、ブラウザアクションで用いられるアイコンよりは若干軽い印象のものにする。Chromeでロケーションバー上に使われるアイコンの多くは19ピクセルよりも小さなもので、縁までいっぱいに描かれたものがあっても、それは淡い影などのみである。
• 常にアニメーションするようなアイコンにしない。鬱陶しいだけになる。

例

ページアクションに関するシンプルな例を、 examples/api/pageAction から閲覧することができる。それ以外のサンプルは から探す。

API

chrome.pageAction参照。