OLD | NEW |
1 <h1>Options</h1> | 1 <h1>Options</h1> |
2 | 2 |
3 <p class="warning"> | 3 <p class="warning"> |
4 This new way of writing options is only supported from Chrome 40 onwards. | 4 This new way of writing options is only supported from Chrome 40 onwards. |
5 <a href="options">See the old documentation</a>. | 5 <a href="options">See the old documentation</a>. |
6 </p> | 6 </p> |
7 | 7 |
8 <p> | 8 <p> |
9 To allow users to customize the behavior of your extension, you may wish to | 9 To allow users to customize the behavior of your extension, you may wish to |
10 provide an options page. | 10 provide an options page. |
(...skipping 167 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
178 ensure that the dialogue will find an appropriate size. | 178 ensure that the dialogue will find an appropriate size. |
179 </p> | 179 </p> |
180 | 180 |
181 <h2 id="migration">Migrating from old options pages</h2> | 181 <h2 id="migration">Migrating from old options pages</h2> |
182 <p class="warning"> | 182 <p class="warning"> |
183 At least until Chrome 40 is stable, you should specify <strong>both</strong> | 183 At least until Chrome 40 is stable, you should specify <strong>both</strong> |
184 the <code>options_ui</code> <strong>and</strong> the <code>options_page</code> | 184 the <code>options_ui</code> <strong>and</strong> the <code>options_page</code> |
185 fields. | 185 fields. |
186 <br><br> | 186 <br><br> |
187 Older versions of Chrome will only recognize <code>options_page</code>, and | 187 Older versions of Chrome will only recognize <code>options_page</code>, and |
188 only open in tabs. Chrome 40 and onwards prefers to use the | 188 only open in tabs. Chrome 40 and onwards prefer to use the |
189 <code>options_ui</code> field if it's specified. | 189 <code>options_ui</code> field if it's specified. |
190 </p> | 190 </p> |
191 | 191 |
192 The <code>options_ui</code> manifest field and embedded extension options | 192 The <code>options_ui</code> manifest field and embedded extension options |
193 were introduced in Chrome 40. Prior to these changes, options pages were always | 193 were introduced in Chrome 40. Prior to these changes, options pages were always |
194 displayed in new tabs and were declared using the <code>options_page</code> | 194 displayed in new tabs and were declared using the <code>options_page</code> |
195 field: | 195 field: |
196 </p> | 196 </p> |
197 | 197 |
198 <pre data-filename="manifest.json"> | 198 <pre data-filename="manifest.json"> |
(...skipping 17 matching lines...) Expand all Loading... |
216 <p> | 216 <p> |
217 If you specify both, Chrome 40 and onwards will ignore the value of | 217 If you specify both, Chrome 40 and onwards will ignore the value of |
218 <code>options_page</code>. | 218 <code>options_page</code>. |
219 </p> | 219 </p> |
220 <p> | 220 <p> |
221 In a future version of Chrome, any extension which specifies | 221 In a future version of Chrome, any extension which specifies |
222 <code>options_page</code> will change to match the <code>options_ui</code> | 222 <code>options_page</code> will change to match the <code>options_ui</code> |
223 behavior - most importantly, they will always be embedded in | 223 behavior - most importantly, they will always be embedded in |
224 <em>chrome://extensions</em> - so migrate as soon as possible. | 224 <em>chrome://extensions</em> - so migrate as soon as possible. |
225 </p> | 225 </p> |
OLD | NEW |