YUI 3 auto complete 提供了两种使用方式:插件(plug) 和实例化
1.插件方式
HTML部分:
<div class="yui3-skin-sam">
<input id="ac-input">
</div>
JS部分:
YUI().use("autocomplete", function (Y) {
var inputNode = Y.one('#ac-input'),
tags = [
'css',
'html',
'js',
'yui'
];
inputNode.plug(Y.Plugin.AutoComplete, {
source: tags,
resultHighlighter: 'startsWith',
});
inputNode.on('focus', function () {
inputNode.ac.sendRequest('');
});
});
这里使用的数据源tags,就是一个简单的数组,实际应用可能使用的是远程数据库的结果。
给输入框节点安装上AutoComplete 插件后,inputNode 会自动生成一个 ac 对象,通过inputNode.ac.on(EventName,fn)来监听事件和绑定回调函数
若果希望,键盘导航,inputNode 中的值会跟着变化
inputNode.ac.on("activeItemChange",function(e){
if(e.newVal){
this.set("value",e.newVal.get("text"),{src:"user"});
//console.log("active change");
}
});
需要注意的是,this.set("value",e.newVal.get("text"),{src:"user"});
第三个参数是一个对象,src,表示这种改变是来自何处,Autocomplete 会区别处理来自用户的输入和非用户的输入,这里官方的API没有作说明,折腾了好长时间!的确YUI好是好,可是它的文档会让一般耐心的人会崩溃掉
YUI().use("autocomplete", function (Y) {
var inputNode = Y.one('#ac-input'),
tags = [
'css',
'html',
'js',
'yui'
];
inputNode.plug(Y.Plugin.AutoComplete, {
source: tags,
resultHighlighter: 'startsWith',
});
// list of tag suggestions.
inputNode.on('focus', function () {
inputNode.ac.sendRequest('');
});
inputNode.ac.on("activeItemChange",function(e){
if(e.newVal){
this.set("value",e.newVal.get("text"),{src:"user"});
//console.log("active change");
}
});
});
如果还要支持鼠标hover时,将hover的项放入inputNode
inputNode.ac.on("hoveredItemChange",function(e){
if(e.newVal)
this.set("activeItem",e.newVal);
})
数据源是通过ajax获得的,需要添加 "datasource-io","datasource-jsonschema"这些包
var ds = new Y.DataSource.IO({
source : "/search.html"
}),
listTemplate ='<div><span class="suggest">{sug}</span><span class="description">{des}</span></div>';
ds.plug({fn : Y.Plugin.DataSourceJSONSchema, cfg : {
schema : {
resultListLocator : "results",
resultFields: [{key:"sug"},{key:"des"}]
}
}});
将上面的 source:tags 换成source:ds
search.html 返回的数据格式:{"results":[{"sug":"sug1","des":"des1"},{"sug":"sug2","des":"des2"}]} ,与schema中描述相对应
另外,一种使用autocomplete 的方式就是作为一个类进行实例化,可以查看官方的文档 http://yuilibrary.com/yui/docs/autocomplete/#as-a-class