详解jQuery UI库中文本输入自动补全功能的用法


Posted in Javascript onApril 23, 2016

自动补全(autocomplete),是一个可以减少用户输入完整信息的UI 工具。一般在
输入邮箱、搜索关键字等,然后提取出相应完整字符串供用户选择。

一.调用autocomplete()方法

$('#email').autocomplete({ 
 
  source : ['aaa@163.com', 'bbb@163.com', 'ccc@163.com'], 
 
});

二.修改autocomplete()样式
   由于autocomplete()方法是弹窗,然后鼠标悬停的样式。通过Firebug 想获取到
悬停时背景的样式,可以直接通过jquery.ui.css 里面找相应的CSS。

//无须修改ui 里的CSS,直接用style.css 替代掉 
.ui-menu-item a.ui-state-focus { 
 
  background:url(../img/xxx.png); 
 
}

三.autocomplete()方法的属性
   自动补全方法有两种形式:1.autocomplete(options),options 是以对象键值对
的形式传参,每个键值对表示一个选项;2.autocomplete('action', param),action
是操作对话框方法的字符串,param 则是options 的某个选项。

autocomplete 外观选项
属性 默认值/类型 说明
disabled  false/布尔值 设置为true,将禁止显示自动补全。
source  无/数组 指定数据源,可以是本地的,也可以是远程的。
minLength  1/数值 默认为1,触发补全列表最少输入字符数。
delay  300/数值 默认为300 毫秒,延迟显示设置。
autoFocus  false/布尔值 设置为true 时,第一个项目会自动被选定。

$('#email').autocomplete({ 
 
  source : ['aaa@163.com', 'bbb@163.com', 'ccc@163.com'], 
 
  disabled : false, 
 
  minLength : 2, 
 
  delay : 50, 
 
  autoFocus : true, 
 
});

autocomplete 页面位置选项
属性 默认值/类型 说明
position 无/对象 使用对象的键值对赋值,有两个属性:my 和at 表示坐标。my 是以目标点左上角为基准,at 以 目标点右下角为基准。

$('#email').autocomplete({ 
 
  position : { 
 
   my : 'left center', 
 
   at : 'right center' 
 
  } 
 
});

四.autocomplete()方法的事件
   除了属性设置外,autocomplete()方法也提供了大量的事件。这些事件可以给各
种不同状态时提供回调函数。这些回调函数中的this 值等于对话框内容的div 对象,不
是整个对话框的div。
autocomplete 事件选项

autocomplete 事件选项
事件名 说明
create 当自动补全被创建时会调用create 方法,该方法有两个 参数(event, ui)。此事件中的ui 参数为空。
open 当自动补全被显示时,会调用open 方法,该方法有两个 参数(event, ui)。此事件中的ui 参数为空。
close 当自动补全被关闭时,会调用close 方法,该方法有两个 参数(event, ui)。此事件中的ui 参数为空。
focus 当自动补全获取焦点时,会调用focus 方法,该方法有两 个参数(event, ui)。此事件中的ui 有一个子属性对象item, 分别有两个属性:label,补全列表显示的文本;value, 将要输入框的值。一般label 和value 值相同。
select 当自动补全获被选定时,会调用select 方法,该方法有两 个参数(event, ui)。此事件中的ui 有一个子属性对象item, 分别有两个属性:label,补全列表显示的文本;value, 将要输入框的值。一般label 和value 值相同。
change 当自动补全失去焦点且内容发生改变时,会调用change 方法,该方法有两个参数(event, ui)。此事件中的ui 参数 为空。
search 当自动补全搜索完成后,会调用search 方法,该方法有 两个参数(event, ui)。此事件中的ui 参数为空。
response 当自动补全搜索完成后,在菜单显示之前,会调用 response 方法,该方法有两个参数(event, ui)。此事件中 的ui 参数有一个子对象content,他会返回label 和value 值,可通过遍历了解。

$('#email').autocomplete({ 
 
  source : ['aaa@163.com', 'bbb@163.com', 'ccc@163.com'], 
 
  disabled : false, 
 
  minLength : 1, 
 
  delay : 0, 
 
  focus : function (e, ui) { 
 
   ui.item.value = '123'; 
 
  }, 
 
  select : function (e, ui) { 
 
    ui.item.value = '123'; 
 
  }, 
 
  change : function (e, ui) { 
 
   alert(''); 
 
  }, 
 
  search : function (e, ui) { 
 
   alert(''); 
 
  }, 
 
}); 
autocomplete('action', param)方法
autocomplete('action', param)方法
方法 返回值 说明
autocomplete('close')  jQuery 对象 关闭自动补齐
autocomplete('disable')  jQuery 对象 禁用自动补齐
autocomplete('enable')  jQuery 对象 启用自动补齐
autocomplete('destroy')  jQuery 对象 删除自动补齐,直接阻断
autocomplete('widget')  jQuery 对象 获取工具提示的jQuery 对象
autocomplete('search',value)  jQuery 对象 在数据源获取匹配的字符串
autocomplete('option', param)  一般值 获取options 属性的值
autocomplete('option', param,value)  jQuery 对象 设置options 属性的值
$('#reg').on('autocompleteopen', function () { alert('打开时触发!'); });

五、邮箱自动补全
  通过自动补全source 属性的function 回调函数,来动态的设置数据源,以达到可以
实现邮箱补全功能。

1.数据源function
   自动补全UI 的source 不但可以是数组,也可以是function 回调函数。提供了自带的
两个参数设置动态的数据源。

$('#email').autocomplete({ 
 
  source : function (request, response) { 
 
   alert(request.term);    //可以获取你输入的值 
 
   response(['aa', 'aaaa', 'aaaaaa', 'bb']);    //展示补全结果 
 
  }, 
 
});

注意:这里的response 不会根据你搜索关键字而过滤无关结果,而是把整个结果全部呈现出
来。因为source 数据源,本身就是动态改变的,就由自定义,从而放弃系统内置的搜索能力。

2.邮箱自动补全

$('#email').autocomplete({ 
 
  autoFocus : true, 
 
  delay : 0, 
 
  source : function (request, response) { 
 
   var hosts = ['qq.com','163.com', '263.com', 'gmail.com', 'hotmail.com'],    //起始 
 
     term = request.term,    //获取输入值 
 
     ix = term.indexOf('@'),    //@ 
 
     name = term,    //用户名 
 
     host = '',    //域名  
 
     result = [];    //结果 
 
   //结果第一条是自己输入 
   result.push(term); 
 
   if (ix > -1) {    //如果有@的时候 
 
     name = term.slice(0, ix);    //得到用户名 
 
     host = term.slice(ix + 1);    //得到域名 
 
   } 
 
   if (name) { 
 
     //得到找到的域名 
     var findedHosts = (host ? $.grep(hosts, function (value, index) { 
 
                 return value.indexOf(host) > -1; 
 
               }) : hosts), 
 
     //最终列表的邮箱 
     findedResults = $.map(findedHosts, function (value, index) { 
 
              return name + '@' + value; 
 
             }); 
 
     //增加一个自我输入 
     result = result.concat(findedResults); 
 
   } 
 
   response(result); 
 
  }, 
 
});
Javascript 相关文章推荐
关于JAVASCRIPT urldecode URL解码的问题
Jan 08 Javascript
jqGrid随窗口大小变化自适应大小的示例代码
Dec 28 Javascript
js读写json文件实例代码
Oct 21 Javascript
javascript 应用小技巧方法汇总
Jul 05 Javascript
jQuery跨域问题解决方案
Aug 03 Javascript
jQuery ajax MD5实现用户注册即时验证功能
Oct 11 Javascript
微信公众号  提示:Unauthorized API function 问题解决方法
Dec 05 Javascript
jQuery Validate表单验证插件的基本使用方法及功能拓展
Jan 04 Javascript
jQuery实现动态生成表格并为行绑定单击变色动作的方法
Apr 17 jQuery
JS禁止浏览器右键查看元素或按F12审查元素自动关闭页面示例代码
Sep 07 Javascript
使用Ajax和Jquery配合数据库实现下拉框的二级联动的示例
Jan 25 jQuery
webpack下实现动态引入文件方法
Feb 22 Javascript
AngularJS中的过滤器filter用法完全解析
Apr 22 #Javascript
举例讲解如何判断JavaScript中对象的类型
Apr 22 #Javascript
使用jQuery制作基础的Web图片轮播效果
Apr 22 #Javascript
使用jQuery UI库开发Web界面的简单入门指引
Apr 22 #Javascript
jQuery 监控键盘一段时间没输入
Apr 22 #Javascript
基于jquery实现轮播特效
Apr 22 #Javascript
jquery插件Jplayer使用方法简析
Apr 22 #Javascript
You might like
老照片 - 几十年前的收音机与人
2021/03/02 无线电
来自PHP.NET的入门教程
2006/10/09 PHP
微信公众号开发之微信公共平台消息回复类实例
2014/11/14 PHP
PHP实现查询两个数组中不同元素的方法
2016/02/23 PHP
CI框架数据库查询缓存优化的方法
2016/11/21 PHP
PHP7.3.10编译安装教程
2019/10/08 PHP
灵活应用js调试技巧解决样式问题的步骤分享
2012/03/15 Javascript
jquery触发a标签跳转事件示例代码
2013/07/21 Javascript
jQuery实现内容定时切换效果完整实例
2016/04/06 Javascript
vue + socket.io实现一个简易聊天室示例代码
2017/03/06 Javascript
浅谈通过JS拦截 pushState和replaceState事件
2017/07/21 Javascript
深入浅出es6模板字符串
2017/08/26 Javascript
使用vs code开发Nodejs程序的使用方法
2017/09/21 NodeJs
Koa2 之文件上传下载的示例代码
2018/03/29 Javascript
深入浅析Vue中的 computed 和 watch
2018/06/06 Javascript
layui-table获得当前行的上/下一行数据的例子
2019/09/24 Javascript
Vue实现数据请求拦截
2019/10/23 Javascript
原生js实现自定义难度的扫雷游戏
2021/01/22 Javascript
python 线程的暂停, 恢复, 退出详解及实例
2016/12/06 Python
详解pandas如何去掉、过滤数据集中的某些值或者某些行?
2019/05/15 Python
python 处理微信对账单数据的实例代码
2019/07/19 Python
python自动循环定时开关机(非重启)测试
2019/08/26 Python
解决pycharm最左侧Tool Buttons显示不全的问题
2019/12/17 Python
python/golang 删除链表中的元素
2020/09/14 Python
Python django框架 web端视频加密的实例详解
2020/11/20 Python
Belstaff英国官方在线商店:Belstaff.co.uk
2021/02/09 全球购物
优秀研究生自我鉴定
2013/12/04 职场文书
小学教师自我鉴定范文
2014/03/20 职场文书
中国梦演讲稿教师篇
2014/04/23 职场文书
雏鹰争章活动总结
2014/05/09 职场文书
领导干部对照检查材料
2014/08/24 职场文书
公司的门卫岗位职责
2014/09/09 职场文书
二年级学生期末评语
2014/12/26 职场文书
2015大学生暑假调查报告
2015/07/13 职场文书
诚实守信主题班会
2015/08/13 职场文书
幼儿园大班开学寄语(2016秋季)
2015/12/03 职场文书