jQuery UI library_jquery의 텍스트 입력 자동 완성 기능 사용법에 대한 자세한 설명

자동 완성은 사용자가 완전한 정보를 입력할 필요성을 줄여주는 UI 도구입니다. 보통
이메일 주소, 검색 키워드 등을 입력한 후 사용자가 선택할 수 있도록 해당 전체 문자열을 추출합니다.

1. autocomplete() 메소드 호출

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

2. 자동완성() 스타일 수정
autocomplete() 메소드는 팝업 창이므로 마우스 호버 스타일입니다. Firebug를 통해
을(를) 얻고 싶습니다. 마우스 오버 시 배경 스타일은 jquery.ui.css에서 해당 CSS를 직접 찾을 수 있습니다.

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

3. autocomplete() 메소드의 속성
자동 완성 방법에는 두 가지 형태가 있습니다: 1.autocomplete(옵션), 옵션은 객체 키-값 쌍입니다
양식에 매개변수를 전달합니다. 각 키-값 쌍은 옵션을 나타냅니다. 2.autocomplete('action', param), action
대화상자 방식을 동작시키기 위한 문자열이며, param은 options의 옵션이다.

속성

autocomplete 外观选项

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

기본값/유형

설명

비활성화

false/Boolean

자동 완성을 비활성화하려면 true로 설정하세요.

소스

없음/배열

로컬 또는 원격일 수 있는 데이터 소스를 지정합니다.

최소 길이

1/값

기본값은 1이며, 이는 완성 목록을 트리거하는 데 필요한 최소 문자 수입니다.

지연

300/값

기본값은 300밀리초, 지연 표시 설정입니다.

autoFocus

false/Boolean

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)方法

<table border="1" cellspacing="1" cellpadding="1" width="700" height="500"><caption>autocomplete('action', param)方法</caption><tbody><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">方法<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">返回值<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">说明<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('close')<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">关闭自动补齐<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('disable')<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">禁用自动补齐<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('enable')<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">启用自动补齐<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('destroy')<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">删除自动补齐，直接阻断<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('widget')<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">获取工具提示的jQuery 对象<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('search',value)<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">在数据源获取匹配的字符串<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('option', param) <br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">一般值<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">获取options 属性的值<br /></span></td></tr><tr><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">autocomplete('option', param,value)<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px"> jQuery 对象<br /></span></td><td style="text-align: center"><span style="font-family: Courier New; font-size: 14px">设置options 属性的值</span></td></tr></tbody></table>

$('#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); 
 
  }, 
 
});