型 | Object |
---|---|
必須 | いいえ |
例 |
|
chrome_url_overrides
キーを使って、通常はブラウザー自身が行っているいろいろなページへの文書の置き換えをカスタムすることができます。
構文
chrome_url_overrides
キーは次のプロパティを持つオブジェクトです:
名前 | 型 | 説明 |
---|---|---|
bookmark |
String |
ブックマークに出てくるページへの置き換えを提供します。 |
history |
String |
履歴に出てくるページへの置き換えを提供します。 |
newtab |
String |
"新規タブ" ページに出てくる文書の置き換えを提供します。これはユーザーが新しいタブを開いてまだ文書を読み込んでない時のページです: 例えば、 Ctrl/Command+T のキーボードショートカットで。 置き換えは HTML ファイルへの URL として与えられます。ファイルは拡張機能に同梱する必要があります: ここにはリモートの URL を指定できません。拡張機能のルートフォルダーから相対的に、次のように指定できます: "path/to/newtab.html". 文書は通常のウェブページと同様に CSS と JavaScript をロードできます。 ページ内で実行する JavaScript はバックグラウンドスクリプトと同じように privileged "browser.*" APIs のアクセスを得ます。 ページに <title> を入れるのは良い習慣で、そうしないとタブのタイトルは "moz-extension://..." の URL になるでしょう。 よくあるユースケースはユーザーに新しいタブページを定義できるようにすることです: これをするには、ユーザーが定義したページにナビゲートするカスタムの新規タブページを提供します。 2 つ以上の拡張機能がいずれもカスタムの新規タブページを定義する場合、インストールや有効化された最後の分の値を使われます。 ブラウザーのホームページを上書きするには、代わりに"chrome_settings_overrides" を使います。 |
すべてのプロパティはローカライズ可能です。
例
"chrome_url_overrides" : {
"newtab": "my-new-tab.html"
}
ブラウザ実装状況
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.