オーバーライド ページを使用すると、拡張機能の HTML ファイルを、Google Chrome で通常提供されるページに置き換えることができます。オーバーライド ページは通常、HTML に加えて CSS コードと JavaScript コードで構成されます。
拡張機能により、次のいずれかのページを置き換えることができます。
- ブックマーク マネージャ: ユーザーが Chrome メニューからブックマーク マネージャのメニュー項目を選択したとき、または Mac の場合は [ブックマーク] メニューからブックマーク マネージャの項目を選択したときに表示されるページです。このページには、URL「chrome://bookmarks」と入力してアクセスすることもできます。
- 履歴: ユーザーが Chrome メニューから [履歴] メニュー項目を選択したとき、または Mac の場合は [履歴] メニューから [全履歴を表示] 項目を選択したときに表示されるページ。URL「chrome://history」を入力して、このページにアクセスすることもできます。
- 新しいタブ: ユーザーが新しいタブまたはウィンドウを作成したときに表示されるページ。このページには、URL に「chrome://newtab」を入力することもできます。
注: 1 つの拡張機能でオーバーライドできるのは 1 ページのみです。たとえば、1 つの拡張機能でブックマーク マネージャと履歴の両方のページをオーバーライドすることはできません。
シークレット ウィンドウは特別に扱われます。シークレット ウィンドウで新しいタブページをオーバーライドすることはできません。 他のオーバーライド ページは、Incognito マニフェスト プロパティが「spanning」(デフォルト値)に設定されていれば、シークレット ウィンドウで動作します。シークレット ウィンドウの扱い方について詳しくは、「概要」のデータの保存とシークレット モードをご覧ください。
次のスクリーンショットでは、デフォルトの新しいタブページが表示され、その後カスタムの新しいタブページが表示されています。
マニフェスト
拡張機能のマニフェストで、次のようにオーバーライド ページを登録します。
{
"name": "My extension",
...
"chrome_url_overrides" : {
"PAGE_TO_OVERRIDE": "myPage.html"
},
...
}
PAGE_TO_OVERRIDE
は、次のいずれかに置き換えます。
bookmarks
history
newtab
ヒント
オーバーライド ページの効果を高めるには、次のガイドラインに従ってください。
- ページを速く小さくする。 ユーザーは、組み込みのブラウザページがすぐに開くことを期待しています。時間がかかる作業は控えましょう。たとえば、ネットワーク リソースやデータベース リソースの同期取得は避けてください。
- ページのタイトルを含めます。
そうしないと、ユーザーにページの URL が表示され、混乱する可能性があります。以下に、タイトルを指定する例を示します。
<title>New Tab</title>
- キーボードのフォーカスがあるページに頼らないでください。ユーザーが新しいタブを作成すると、常にアドレスバーが最初にフォーカスされます。
- デフォルトの新しいタブページをエミュレートしようとしない。デフォルトの新しいタブページを少し修正したバージョン(トップページ、最近閉じたページ、ヒント、テーマの背景画像など)を作成するために必要な API はまだありません。それまでは、まったく別のものを作ろうとするのがよいでしょう。
例
オーバーライドのサンプルをご覧ください。