1 <p> 2 <img src="{{static}}/images/omnibox.png" width="300" height="150" 3 alt="A screenshot showing suggestions related to the keyword 'Chromium Search'"/> 4 </p> 5 6 <p> 7 When the user enters your extension's 8 keyword, the user starts 9 interacting solely with your extension. 10 Each keystroke is sent to your 11 extension, and you can provide suggestions 12 in response. 13 </p> 14 15 <p> 16 The suggestions can be richly formatted 17 in a variety of ways. 18 19 When the user accepts 20 a suggestion, your extension is notified 21 and can take action. 22 </p> 23 24 <h2 id="manifest">Manifest</h2> 25 26 <p> 27 You must include an <code>omnibox</code> <code>keyword</code> field 28 in the <a href="manifest.html">manifest</a> 29 to use the omnibox API. 30 You should also 31 specify a 16x16-pixel icon, which will be 32 displayed in the address bar when suggesting that users 33 enter keyword mode. 34 </p> 35 36 <p> 37 For example: 38 </p> 39 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 "persistent": false, 49 "scripts": ["background.js"] 50 } 51 }</pre> 52 53 <p class="note"> 54 <strong>Note:</strong> 55 Chrome automatically creates a grayscale version of 56 your 16x16-pixel icon. You should provide 57 a full-color version so that it can also be 58 used in other situations that require color. 59 For example, the <a href="contextMenus.html" 60 >context menus API</a> also uses a 16x16-pixel 61 icon, but it is displayed in color. 62 </p> 63 64 65 <h2 id="examples">Examples</h2> 66 67 <p> 68 You can find samples of this API on the 69 <a href="samples.html#omnibox">sample page</a>. 70
