files/ja/mozilla/add-ons/webextensions/manifest.json/chrome_url_overrides/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

---
title: chrome_url_overrides
slug: Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides
tags:
  - Add-ons
  - Extensions
  - WebExtensions
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides
---
<div>{{AddonSidebar}}</div>

<table class="fullwidth-table standard-table">
 <tbody>
  <tr>
   <th scope="row" style="width: 30%;">型</th>
   <td><code>Object</code></td>
  </tr>
  <tr>
   <th scope="row">必須</th>
   <td>いいえ</td>
  </tr>
  <tr>
   <th scope="row">例</th>
   <td>
    <pre class="brush: json no-line-numbers">
  "chrome_url_overrides" : {
    "newtab": "my-new-tab.html"
  }</pre>
   </td>
  </tr>
 </tbody>
</table>

<p><code>chrome_url_overrides</code> キーを使って、通常はブラウザー自身が行っているいろいろなページへの文書の置き換えをカスタムすることができます。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<p><code>chrome_url_overrides</code> キーは次のプロパティを持つオブジェクトです:</p>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col">名前</th>
   <th scope="col">型</th>
   <th scope="col">説明</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>bookmark</code></td>
   <td><code>String</code></td>
   <td>
    <p>ブックマークに出てくるページへの置き換えを提供します。</p>
   </td>
  </tr>
  <tr>
   <td><code>history</code></td>
   <td><code>String</code></td>
   <td>
    <p>履歴に出てくるページへの置き換えを提供します。</p>
   </td>
  </tr>
  <tr>
   <td><code>newtab</code></td>
   <td><code>String</code></td>
   <td>
    <p>"新規タブ" ページに出てくる文書の置き換えを提供します。これはユーザーが新しいタブを開いてまだ文書を読み込んでない時のページです: 例えば、 <kbd>Ctrl</kbd>/<kbd>Command</kbd>+<kbd>T</kbd> のキーボードショートカットで。</p>

    <p>置き換えは HTML ファイルへの URL として与えられます。ファイルは拡張機能に同梱する必要があります: ここにはリモートの URL を指定できません。拡張機能のルートフォルダーから相対的に、次のように指定できます: "path/to/newtab.html".</p>

    <p>文書は通常のウェブページと同様に CSS と JavaScript をロードできます。 ページ内で実行する JavaScript はバックグラウンドスクリプトと同じように <a href="/ja/Add-ons/WebExtensions/API">privileged "browser.*" APIs</a> のアクセスを得ます。</p>

    <p>ページに <a href="/ja/docs/Web/HTML/Element/title">&lt;title&gt;</a> を入れるのは良い習慣で、そうしないとタブのタイトルは "moz-extension://..." の URL になるでしょう。</p>

    <p>よくあるユースケースはユーザーに新しいタブページを定義できるようにすることです: これをするには、ユーザーが定義したページにナビゲートするカスタムの新規タブページを提供します。</p>

    <p>2 つ以上の拡張機能がいずれもカスタムの新規タブページを定義する場合、インストールや有効化された最後の分の値を使われます。</p>

    <p>ブラウザーのホームページを上書きするには、代わりに"<a href="/ja/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides">chrome_settings_overrides</a>" を使います。</p>
   </td>
  </tr>
 </tbody>
</table>

<p>すべてのプロパティは<a href="https://developer.mozilla.org/ja/Add-ons/WebExtensions/Internationalization#Internationalizing_manifest.json">ローカライズ可能です</a>。</p>

<h2 id="Example" name="Example">例</h2>

<pre class="brush: json no-line-numbers">"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}</pre>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{Compat("webextensions.manifest.chrome_url_overrides")}}</p>