Omnibox
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
Methods
method name
void chrome.module.methodName(, )Undocumented.
A description from the json schema def of the function goes here.
Parameters
Returns
Callback function
The callback parameter should specify a function that looks like this:
If you specify the callback parameter, it should specify a function that looks like this:
function(Type param1, Type param2) {...};
This function was added in version . If you require this function, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
setDefaultSuggestion
void chrome.omnibox.setDefaultSuggestion(, object suggestion)Undocumented.
设置缺省建议的描述和风格。缺省建议是显示在 URL地址栏下的第一个建议显示文字
Parameters
- suggestion ( optional enumerated Type array of object )
- Undocumented.
- 一个局部的SuggestResult 对象，没有'content' 参数。关于该参数的描述，请参见SuggestResult。
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
- description ( optional enumerated Type array of string )
- Undocumented.
- 显示在缺省建议中的文本，可以包含'%s'并可以被用户输入替换。
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
Returns
Callback function
The callback parameter should specify a function that looks like this:
If you specify the callback parameter, it should specify a function that looks like this:
function(Type param1, Type param2) {...};
This function was added in version . If you require this function, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
Events
onInputCancelled
chrome.omnibox.onInputCancelled.addListener(function() {...});Undocumented.
用户结束键盘输入会话，但未接受该输入（取消了输入）。
Parameters
onInputChanged
chrome.omnibox.onInputChanged.addListener(function(string text, function suggest) {...});Undocumented.
用户修改了在 omnibox中的输入。
Parameters
- text ( optional enumerated Type array of string )
- Undocumented.
- Description of this parameter from the json schema.
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
- suggest ( optional enumerated Type array of function )
- Undocumented.
- 一个传给onInputChanged 事件的回调，用来在事件发生的时候，发送回建议给浏览器。
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
Parameters
- paramName ( optional enumerated Type array of SuggestResult array of paramType paramType )
- Undocumented.
- 建议结果，数组。
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
onInputEntered
chrome.omnibox.onInputEntered.addListener(function(string text) {...});Undocumented.
用户接收了omnibox中的数据。
Parameters
- text ( optional enumerated Type array of string )
- Undocumented.
- Description of this parameter from the json schema.
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
onInputStarted
chrome.omnibox.onInputStarted.addListener(function() {...});Undocumented.
用户输入扩展的关键字，开始了一个键盘输入会话。 这个事件在会话开始时发送，早于其它事件，而且一个会话只会发送一次。
Parameters
Types
SuggestResult
- content ( optional enumerated Type array of string )
- Undocumented.
- 在URL区域中的文本，当用户选择该条目时发送给扩展。
- This parameter was added in version . You must omit this parameter in earlier versions, and you may omit it in any version. If you require this parameter, the manifest key minimum_chrome_version can ensure that your extension won't be run in an earlier browser version.
- description ( optional enumerated Type array of string )
- Undocumented.
- The URL下拉列表中显示的文本。可以包含一个XML风格标记。支持的标签是'url' (作为一个文法上的URL)， 'match' (作为匹配用户请求数据的高亮文本显示)，以及 'dim' (作为灰色辅助文本)。风格可以嵌套。