JQuery autocomplete 使用手册


Posted in Javascript onApril 01, 2010

官方网站:http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete
当前版本:1.1
需要JQuery版本:1.2.6+
首先是最重要的方法
autocomplete( url or data, [options] )
第一个参数可以是数组或者url。options参数比较复杂:
* minChars (Number):
在触发autoComplete前用户至少需要输入的字符数.Default: 1,如果设为0,在输入框内双击或者删除输入框内内容时显示列表
* width (Number):
指定下拉框的宽度. Default: input元素的宽度
* max (Number):
autoComplete下拉显示项目的个数.Default: 10
* delay (Number):
击键后激活autoComplete的延迟时间(单位毫秒).Default: 远程为400 本地10
* autoFill (Boolean):
要不要在用户选择时自动将用户当前鼠标所在的值填入到input框. Default: false
* mustMatch (Booolean):
如果设置为true,autoComplete只会允许匹配的结果出现在输入框,所有当用户输入的是非法字符时将会得不到下拉框.Default: false
* matchContains (Boolean):
决定比较时是否要在字符串内部查看匹配,如ba是否与foo bar中的ba匹配.使用缓存时比较重要.不要和autofill混用.Default: false
* selectFirst (Boolean):
如果设置成true,在用户键入tab或return键时autoComplete下拉列表的第一个值将被自动选择,尽管它没被手工选中(用键盘或鼠标).当然如果用户选中某个项目,那么就用用户选中的值. Default: true
* cacheLength (Number):
缓存的长度.即对从数据库中取到的结果集要缓存多少条记录.设成1为不缓存.Default: 10
* matchSubset (Boolean):
autoComplete可不可以使用对服务器查询的缓存,如果缓存对foo的查询结果,那么如果用户输入foo就不需要再进行检索了,直接使用缓存.通常是打开这个选项以减轻服务器的负担以提高性能.只会在缓存长度大于1时有效.Default: true
* matchCase (Boolean):
比较是否开启大小写敏感开关.使用缓存时比较重要.如果你理解上一个选项,这个也就不难理解,就好比foot要不要到FOO的缓存中去找.Default: false
* multiple (Boolean):
是否允许输入多个值即多次使用autoComplete以输入多个值. Default: false
* multipleSeparator (String):
如果是多选时,用来分开各个选择的字符. Default: ","
* scroll (Boolean):
当结果集大于默认高度时是否使用卷轴显示 Default: true
* scrollHeight (Number):
自动完成提示的卷轴高度用像素大小表示 Default: 180
* formatItem (Function):
为每个要显示的项目使用高级标签.即对结果中的每一行都会调用这个函数,返回值将用LI元素包含显示在下拉列表中. Autocompleter会提供三个参数(row, i, max): 返回的结果数组, 当前处理的行数(即第几个项目,是从1开始的自然数), 当前结果数组元素的个数即项目的个数. Default: none, 表示不指定自定义的处理函数,这样下拉列表中的每一行只包含一个值.
* formatResult (Function):
和formatItem类似,但可以将将要输入到input文本框内的值进行格式化.同样有三个参数,和formatItem一样.Default: none,表示要么是只有数据,要么是使用formatItem提供的值.
* formatMatch (Function):
对每一行数据使用此函数格式化需要查询的数据格式. 返回值是给内部搜索算法使用的. 参数值row
* extraParams (Object):
为后台(一般是服务端的脚本)提供更多的参数.和通常的作法一样是使用一个键值对对象.如果传过去的值是{ bar:4 },将会被autocompleter解析成my_autocomplete_backend.php?q=foo&bar=4 (假设当前用户输入了foo). Default: {}

result(handler, item)
为选中后触发的事件。item为选中的相。
例如,我们可以在选中后直接跳转页面:

var data = [ {text:'Link A', url:'/page1'}, {text:'Link B', url: '/page2'} ]; 
$("...").autocomplete(data, { 
formatItem: function(item) { 
return item.text; 
} 
}).result(function(event, item) { 
location.href = item.url; 
});

文档地址:http://docs.jquery.com/Plugins/Autocomplete#API_Documentation

使用实例代码:
Jquery AutoComplete自动完成 的使用方法实例

Javascript 相关文章推荐
Javascript客户端将指定区域导出到Word、Excel的代码
Oct 22 Javascript
js DOM 元素ID就是全局变量
Sep 20 Javascript
遍历DOM对象内的元素属性示例代码
Feb 08 Javascript
jquery实现在页面加载完毕后获取图片高度或宽度
Jun 16 Javascript
javascript实现英文首字母大写
Apr 23 Javascript
JavaScript常用字符串与数组扩展函数小结
Apr 24 Javascript
jQuery Ztree行政地区树状展示(点击加载)
Nov 09 Javascript
JSON键值对序列化和反序列化解析
Jan 24 Javascript
跨域解决之JSONP和CORS的详细介绍
Nov 21 Javascript
Vue发布订阅模式实现过程图解
Apr 30 Javascript
Vue $emit()不能触发父组件方法的原因及解决
Jul 28 Javascript
原生js实现简单轮播图
Oct 26 Javascript
JavaScript 弹出窗体点击按钮返回选择数据的实现
Apr 01 #Javascript
js 实现打印网页中定义的部分内容的代码
Apr 01 #Javascript
js prototype截取字符串函数
Apr 01 #Javascript
javascript getElementsByClassName函数
Apr 01 #Javascript
JS getStyle获取最终样式函数代码
Apr 01 #Javascript
Javascript 通过json自动生成Dom的代码
Apr 01 #Javascript
JS中confirm,alert,prompt函数使用区别分析
Apr 01 #Javascript
You might like
国王的咖啡这么大来头,名字的由来是什么
2021/03/03 咖啡文化
用PHP读取flv文件的播放时间长度
2009/09/03 PHP
php+mysql实现用户注册登陆的方法
2015/01/03 PHP
PHP 5.6.11中CURL模块问题的解决方法
2016/08/08 PHP
php文件上传、下载和删除示例
2020/08/28 PHP
php7函数,声明,返回值等新特性介绍
2018/05/25 PHP
PHP连接MySQL数据库操作代码实例解析
2020/07/11 PHP
javascript 图片上一张下一张链接效果代码
2010/03/12 Javascript
js实现双向链表互联网机顶盒实战应用实现
2011/10/28 Javascript
跟我学习javascript的严格模式
2015/11/16 Javascript
基于jQuery实现表格内容的筛选功能
2016/08/21 Javascript
一个非常好用的文字滚动的案例,鼠标悬浮可暂停[两种方案任选]
2016/12/01 Javascript
vue中使用v-model完成组件间的通信
2019/08/22 Javascript
[01:05:12]2014 DOTA2国际邀请赛中国区预选赛 TongFu VS CIS-GAME
2014/05/21 DOTA
[06:15]2016国际邀请赛中国区预选赛单车采访:我顶WINGS
2016/06/27 DOTA
python爬虫入门教程之糗百图片爬虫代码分享
2014/09/02 Python
在Python的struct模块中进行数据格式转换的方法
2015/06/17 Python
Python环境下安装使用异步任务队列包Celery的基础教程
2016/05/07 Python
Python中常见的异常总结
2018/02/20 Python
python matplotlib实现双Y轴的实例
2019/02/12 Python
python实现通过flask和前端进行数据收发
2019/08/22 Python
python实现查找所有程序的安装信息
2020/02/18 Python
python pyecharts 实现一个文件绘制多张图
2020/05/13 Python
一篇文章带你学习CSS3图片边框
2020/11/04 HTML / CSS
amazeui时间组件的实现示例
2020/08/18 HTML / CSS
来自世界上最好大学的在线课程:edX
2018/10/16 全球购物
Linux文件操作命令都有哪些
2015/02/27 面试题
GWT都有什么特性
2016/12/02 面试题
大学本科毕业生求职信范文
2013/12/18 职场文书
转党组织关系介绍信
2014/01/08 职场文书
三八活动策划方案
2014/08/17 职场文书
出国导师推荐信
2015/03/25 职场文书
三八红旗手主要事迹材料
2015/11/04 职场文书
新手,如何业余时间安排好写作、提高写作能力?
2019/10/21 职场文书
python自然语言处理之字典树知识总结
2021/04/25 Python
浅谈spring boot使用thymeleaf版本的问题
2021/08/04 Java/Android