原文:https://github.com/devbridge/jQuery-Autocomplete#ajax-only-settings
通用设置
(1)noCache
默认值false,是否缓存suggestion结果。
(2)delimiter
可选,String或正则表达式,拆分输入值,并取最后一部分用于查询suggestion。
(3)minChars
默认值1,触发autosuggest的最小字符数
(4)triggerSelectOnValidInput
默认值true,如果匹配了suggestion是否触发select方法。
(5)preventBadQueries
默认值true,如果有一个前缀没有获取结果,是否阻止以此开头的其它ajax请求。
(6)autoSelectFirst
默认值false,如果设置为true,当显示suggestion时是否第一项被选择。
(7)beforeRender
可选 ,function(container,suggestions){} 在显示suggestions之前调用。
(8)formatResult
可选, function(suggestion,currentValue){},格式化suggestion项到suggestion container中。
(9)formatGroup
可选,function(suggestion,category){},格式化分组头
(10)groupBy
可选, 指定用于分组的属性。
(11)maxHeight
默认300,suggestion container的最大高度(pixels)
(12)width
默认值auto,suggestion container的宽度(pixels),flex是最大suggestion大小,auto取input的宽度。
(13)zIndex
默认值9999,suggestion container的‘z-index’值
(14)appendTo
可选,指定suggestion要添加到的container,默认值是document.body,
(15)forceFixPosition
默认值false,当container是body时,suggestion是自动排放的,其它情况时,可以用来强制自动排放。
(16)orientation
默认值bottom,suggestion显示时的方向,可以是auto,top bottom
(17)preserverInput
默认值false,如果设置为true,在suggestion之间移动时不改变input值
(18)showNoSuggestionNotice
(19)noSuggestionNotice
(20)onInvalidateSelectioin
可选, function(){}, 当已经选择了suggestion时触发的函数
(21)tabDisabled
默认值false,是否可以用tab键进行选择suggestion。
事件函数设置
(1)onSearchStart
function(params){}在ajax请求之前调用。
(2)onHint
function(hint){}用于自动把Input值设置为第一个suggestion
(3)onSearchComplete
function(query,suggest){},在处理ajax响应进调用
(4)transformResult
function(response,orginalQuery){},请求返回结果ok时调用,用于把result转化为response.suggestion
(5)onSelect
function(suggestion){},当用户选择suggestion时调用。
(6)onSearchError
function(query,jqXHR,textStatus,errorThrown){},如果ajax请求时失败时调用
(7)onHide
function(container){},在container隐藏前调用
本地设置
(1)lookupLimit
默认值no limit,本地显示结果的最大数目
(2)lookup
(3)suggestion
{value:'String',data:any}
(4)lookupFilter
function(suggestion,query,queryLowerCase){}
ajax设置
(1)serviceUrl
ajax请求url
(2)type
默认GET
(3)dataType
默认text
(4)paramName
(5)params
可选
(6)deferRequestBy0
推迟ajax请求的ms数
(7)ajaxSetting
可选
实例方法
(1)setOptions(options)
(2)clear
(3)clearCache
(4)disable
(5)enable
(6)hide
(7)dispose