suggestion : 自动推荐

介绍

能通过输入的内容进行联想自动补全

使用方法

 
define(['fui/suggestion/1.0'], function(Suggestion){
	var suggestion = new Suggestion({
		target:"#test1"
	});
});

配置参数

配置参数 参数类型/可选值 参数默认值 作用说明
api string "http:\/\/suggest.1688.com\/bin\/suggest" jsonp接口
param object {} 需要传入接口的参数
queryName string 'q' 关键字参数的参数名
target string "" 需要自动补全功能的目标元素的jQuery选择器
dLeft number 0 下拉框的位置向左微调的像素数,负值代表向右微调
dTop number 0 下拉框的位置向上微调的像素数,负值代表向下微调
minLength number 0 target中字符数的最短长度,当达到minLength时触发采集数据的逻辑
filter function null 对jsonp的返回结果进行处理,处理成合法的格式
renderList function 显示每一项的label值 自定义下拉框内容
beforeRequest function / 在发送Jsonp请求前的处理,若返回false,则不再发送JSONP请求
itemClass string "fui-autocomplete-item" 下拉框中每一项的默认class
classPrefix string 'fui-autocomplete' class前缀

公共方法

方法名称 入参说明 返回值 作用说明
resetPosition() / 组件实例本身 重新定位下拉框的位置
hide() / / 隐藏下拉选项

事件

事件名称 事件说明
dataReady 组件使用者需要触发的事件,使用场景:当异步取到数据时,需要触发此事件来让组件渲染下拉框内容,参数:dataList
select 当选中时,组件会触发该事件,用户可以监听