このページは Cloud Translation API によって翻訳されました。

Chrome ページのオーバーライド

オーバーライドページを使用すると、Google が検出したページを、ご使用の拡張機能の HTML ファイルに置き換えることができます。 Chrome では通常提供されます。HTML に加えて、オーバーライドページには通常、CSS と JavaScript のコードが含まれています。

拡張機能は次のいずれかのページを置き換えることができます。

ブックマークマネージャー: ブックマークマネージャーのメニュー項目を選択したときに表示されるページ Chrome メニュー、または Mac の場合は [ブックマークマネージャ] メニューの [ブックマークマネージャ] をクリックします。また、このページにアクセスするには、URL「chrome://bookmarks」を入力します。
履歴: ユーザーが Chrome で [履歴] メニュー項目を選択したときに表示されるページ Mac の場合は [履歴] メニューの [全履歴を表示] を選択します。このページには「chrome://history」という URL を入力します。
新しいタブ: ユーザーが新しいタブやウィンドウを作成すると表示されるページ。また、「chrome://newtab」と入力します。

注: 1 つの拡張機能でオーバーライドできるのは 1 ページのみです。たとえば、拡張機能でブックマークマネージャと履歴ページの両方をオーバーライドすることはできません。

シークレットウィンドウは特別に扱われます。シークレットウィンドウで新しいタブページをオーバーライドすることはできません。他のオーバーライドページは、シークレットマニフェストプロパティが設定されている限り、シークレットウィンドウでも機能します。「spanning」に設定（デフォルト値）。データの保存とシークレットモードに関するシークレットウィンドウの扱い方について詳しく説明します。

次のスクリーンショットは、デフォルトの新しいタブページとカスタムの新しいタブページです。

デフォルトの新しいタブページ

カスタムの新しいタブページ

マニフェスト

拡張機能のマニフェストで、次のようにオーバーライドページを登録します。

{
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

PAGE_TO_OVERRIDE は、次のいずれかに置き換えます。

bookmarks
history
newtab

ヒント

オーバーライドページを効果的に作成するには、次のガイドラインに従ってください。

ページを小さくして短くする。 ユーザーは、組み込みのブラウザページが瞬時に開くことを期待しています。時間がかかる操作を避けるあります。たとえば、ネットワークリソースやデータベースリソースの同期取得は避けてください。
ページにタイトルを追加します。 そうしないと、ユーザーにページの URL が表示されて混乱を招く可能性があります。これがタイトルを指定する: <title>New Tab</title>
キーボードフォーカスがあるページに依存しないでください。 ユーザーが新しいタブを作成すると、常にアドレスバーが最初にフォーカスされます。
デフォルトの新しいタブページをエミュレートしないでください。 デフォルトの新しいタブページを少し変更したバージョン（上部にページ、最近閉じたページ、ヒント、テーマの背景画像などはまだ存在しません。終了まったく違うものを作るほうがいいでしょう。

例

オーバーライドのサンプルをご覧ください。