| OLD | NEW |
|---|
| (Empty) | |
| 1 <!-- BEGIN AUTHORED CONTENT --> |
| 2 <p> |
| 3 The omnibox API allows you to register a |
| 4 keyword with Google Chrome's address bar, |
| 5 which is also known as the omnibox. |
| 6 </p> |
| 7 <p> |
| 8 <img src="/static/images/omnibox.png" width="300" height="150" |
| 9 alt="A screenshot showing suggestions related to the keyword 'Chromium Search'
"/> |
| 10 </p> |
| 11 <p> |
| 12 When the user enters your extension's |
| 13 keyword, the user starts |
| 14 interacting solely with your extension. |
| 15 Each keystroke is sent to your |
| 16 extension, and you can provide suggestions |
| 17 in response. |
| 18 </p> |
| 19 <p> |
| 20 The suggestions can be richly formatted |
| 21 in a variety of ways. |
| 22 <!-- PENDING: for example? (include a mention of method name, maybe show a code
snippet) --> |
| 23 When the user accepts |
| 24 a suggestion, your extension is notified |
| 25 and can take action. |
| 26 </p> |
| 27 <h2 id="manifest">Manifest</h2> |
| 28 <p> |
| 29 You must include an <code>omnibox</code> <code>keyword</code> field |
| 30 in the <a href="manifest.html">manifest</a> |
| 31 to use the omnibox API. |
| 32 You should also |
| 33 specify a 16x16-pixel icon, which will be |
| 34 displayed in the address bar when suggesting that users |
| 35 enter keyword mode. |
| 36 </p> |
| 37 <p> |
| 38 For example: |
| 39 </p> |
| 40 <pre>{ |
| 41 "name": "Aaron's omnibox extension", |
| 42 "version": "1.0", |
| 43 <b>"omnibox": { "keyword" : "aaron" },</b> |
| 44 <b>"icons": {</b> |
| 45 <b>"16": "16-full-color.png"</b> |
| 46 <b>},</b> |
| 47 "background": { |
| 48 "scripts": ["background.js"] |
| 49 } |
| 50 }</pre> |
| 51 <p class="note"> |
| 52 <strong>Note:</strong> |
| 53 Chrome automatically creates a grayscale version of |
| 54 your 16x16-pixel icon. You should provide |
| 55 a full-color version so that it can also be |
| 56 used in other situations that require color. |
| 57 For example, the <a href="contextMenus.html" |
| 58 >context menus API</a> also uses a 16x16-pixel |
| 59 icon, but it is displayed in color. |
| 60 </p> |
| 61 <h2 id="examples">Examples</h2> |
| 62 <p> |
| 63 You can find samples of this API on the |
| 64 <a href="samples.html#omnibox">sample page</a>. |
| 65 <!-- END AUTHORED CONTENT --> |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 10700118:
Extensions Docs Server: First doc conversions (Closed)
Base URL: svn://svn.chromium.org/chrome/trunk/src