jQuery的Autocomplete(自动完成、自动填充)插件有不少,但比较下来我感觉,还是bassistance.de的JQuery Autocomplete plugin比较强大,我们就来写一些代码感受一下。
jquery-autocomplete配置:
<script type="text/javascript" src="/js/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="/js/jquery.autocomplete.min.js"></script>
<link rel="Stylesheet" href="/js/jquery.autocomplete.css" />
首先是一个最简单的Autocomplete(自动完成)代码片段:
1 <html xmlns="http://www.w3.org/1999/xhtml"> 2 <head runat="server"> 3 <title>AutoComplate</title> 4 <script type="text/javascript" src="/js/jquery-1.4.2.min.js"></script> 5 <script type="text/javascript" src="/js/jquery.autocomplete.min.js"></script> 6 <link rel="Stylesheet" href="/js/jquery.autocomplete.css" /> 7 <script type="text/javascript"> 8 $(function() { 9 var data = "Core Selectors Attributes Traversing Manipulation CSS Events Effects Ajax Utilities".split(" "); 10 11 $('#keyword').autocomplete(data).result(function(event, data, formatted) { 12 alert(data); 13 }); 14 }); 15 </script> 16 </head> 17 <body> 18 <form id="form1" runat="server"> 19 <div> 20 <input id="keyword" /> 21 <input id="getValue" value="GetValue" type="button" /> 22 </div> 23 </form> 24 </body> 25 </html>
?
result方法是jQuery Autocomplete插件里的重要方法,它在用户在选定了某个条目时触发。data参数为选中的数据。
一个稍微复杂的例子,可以自定义提示列表:
1 <html xmlns="http://www.w3.org/1999/xhtml"> 2 <head runat="server"> 3 <title>自定义提示</title> 4 <script type="text/javascript" src="/js/jquery-1.4.2.min.js"></script> 5 <script type="text/javascript" src="/js/jquery.autocomplete.min.js"></script> 6 <link rel="Stylesheet" href="/js/jquery.autocomplete.css" /> 7 <script type="text/javascript"> 8 var emails = [ 9 { name: "Peter Pan", to: "peter@pan.de" }, 10 { name: "Molly", to: "molly@yahoo.com" }, 11 { name: "Forneria Marconi", to: "live@japan.jp" }, 12 { name: "Master <em>Sync</em>", to: "205bw@samsung.com" }, 13 { name: "Dr. <strong>Tech</strong> de Log", to: "g15@logitech.com" }, 14 { name: "Don Corleone", to: "don@vegas.com" }, 15 { name: "Mc Chick", to: "info@donalds.org" }, 16 { name: "Donnie Darko", to: "dd@timeshift.info" }, 17 { name: "Quake The Net", to: "webmaster@quakenet.org" }, 18 { name: "Dr. Write", to: "write@writable.com" }, 19 { name: "GG Bond", to: "Bond@qq.com" }, 20 { name: "Zhuzhu Xia", to: "zhuzhu@qq.com" } 21 ]; 22 23 $(function() { 24 $('#keyword').autocomplete(emails, { 25 max: 12, //列表里的条目数 26 minChars: 0, //自动完成激活之前填入的最小字符 27 width: 400, //提示的宽度,溢出隐藏 28 scrollHeight: 300, //提示的高度,溢出显示滚动条 29 matchContains: true, //包含匹配,就是data参数里的数据,是否只要包含文本框里的数据就显示 30 autoFill: false, //自动填充 31 formatItem: function(row, i, max) { 32 return i + '/' + max + ':"' + row.name + '"[' + row.to + ']'; 33 }, 34 formatMatch: function(row, i, max) { 35 return row.name + row.to; 36 }, 37 formatResult: function(row) { 38 return row.to; 39 } 40 }).result(function(event, row, formatted) { 41 alert(row.to); 42 }); 43 }); 44 </script> 45 </head> 46 <body> 47 <form id="form1" runat="server"> 48 <div> 49 <input id="keyword" /> 50 <input id="getValue" value="GetValue" type="button" /> 51 </div> 52 </form> 53 </body> 54 </html>
?
formatItem、formatMatch、formatResult是自定提示信息的关键。
formatItem作用在于可以格式化列表中的条目,比如我们加了“I”,让列表里的字显示出了斜体。
formatMatch是配合formatItem使用,作用在于,由于使用了formatItem,所以条目中的内容有所改变,而我们要匹配的是原始的数据,所以用formatMatch做一个调整,使之匹配原始数据,
formatResult是定义最终返回的数据,比如我们还是要返回原始数据,而不是formatItem过的数据。
?