| 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 |