Omnibox
Contents
omnibox 应用程序界面允许向Google Chrome的地址栏注册一个关键字,地址栏也叫omnibox。
当用户输入你的扩展关键字,用户开始与你的扩展交互。每个击键都会发送给你的扩展,扩展提供建议作为相应的响应。
建议可以被格式化多种方式。当用户接受建议,你的扩展被通知可以执行动作。
Manifest
使用omnibox 应用程序界面,必须在 manifest 中包含omnibox 关键字段。需要指定像素为16x16的图标,以便当用户输入关键字时,在地址栏中显示。
如:
{ "name": "Aaron's omnibox extension", "version": "1.0", "omnibox": { "keyword" : "aaron" }, "icons": { "16": "16-full-color.png" }, "background_page": "background.html" }
提示: Chrome 自动创建灰度模式16x16像素的图标。你应该提供全色版本图标以便可以在其他场景下使用。 如:Context menus API
使用全色的16x16像素图标。
示例
从sample page 页面可以找到使用该API的例子。.
应用程序界面参考: chrome.omnibox
Events
onInputCancelled
chrome.omnibox.onInputCancelled.addListener(function() {...});
用户结束键盘输入会话,但未接受该输入(取消了输入)。
Parameters
onInputChanged
chrome.omnibox.onInputChanged.addListener(function(string text, function suggest) {...});
用户修改了在 omnibox中的输入。
Parameters
-
text
( string )
- Undocumented.
-
suggest
( function )
- 一个传给onInputChanged 事件的回调,用来在事件发生的时候,发送回建议给浏览器。
-
Parameters
-
paramName
( array of SuggestResult )
- 建议结果,数组。
-
paramName