1. 技术文章
  2. jQuery实战开发表单验证与自动完成提示插件

jQuery实战开发表单验证与自动完成提示插件

由 六眼飞鱼酱① 提交于 2019-11-30 14:06:32

本文是介绍两个最常用的jQuery插件. 分别用于表单验证和自动完成提示(类似google suggest).

研究别人的作品真是一件花时间而且痛苦的过程. 当然也和本人英文不好有关. 总觉得控件作者写了很多文档但是都不够系统, 需要深入研究很多的实例后才能了解作者的思路.所以学习和研究一个插件需要很高成本, 如果发现了Bug并修复需要的成本也是未知数(本次我花了较少的时间解决了自动完成提示插件的一个中文bug, 但是如果复杂的bug就不会这么简单了.).

对于简单应用我首先推荐上文中的jQuery UI. 但是jQuery UI解决的问题有限. 使用jQuery插件是我们最后的一个好办法---还算是好办法, 起码比自己开发要好吧?

很多jQuery的插件编码异常优美, 看一看艺龙首页现在的城市输入框控件, 除了需要为输入框手工添加很多很多属性(onkeyup, onkeydown等等), 而且还不够通用, 占用服务器资源和网络资源.但是当初也是花费了很久的时间完成的作品.

站在巨人的肩膀上, 让我感觉写脚本和写设计C#程序一样, 都有高度和深度可以挖掘. 除了使用作者开发好的功能, 还可以学习如何开发和封装javascript控件. 看过优秀的jQuery插件作者的代码和设计思想后, 常常自叹设计水平差距居然如此之大, 增加自认为脚本高手, 比较过后就是C#程序员和架构师之间的差距.

希望大家通过本章节介绍的两个插件, 除了学会如何使用, 还能够略微领悟到如何封装和设计javascript控件.

一.表单验证插件 validate

在提交表单前常要对用户输入进行校验.ASP.NET的验证控件就是用于此目的, 可以同时进行客户端和服务器端验证. 但是验证控件并没有被所有项目采用. 而且在MVC项目中经常使用自己的客户端验证框架.

在比较了若干表单验证插件后, 决定采用validate插件. 因为其使用简单并且灵活.

插件首页:

http://bassistance.de/jquery-plugins/jquery-plugin-validation/

插件文档:

http://docs.jquery.com/Plugins/Validation

配置说明:

http://docs.jquery.com/Plugins/Validation/validate#options

1.应用实例

实例效果:

image

实例代码:


  
  1. <%@ Page Language="C#" %>     
  
    2. 
  
  
 
   
  2.     
  
    3. 
  
  
 
   
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">     
  
    4. 
  
  
 
   
  4. <html xmlns="http://www.w3.org/1999/xhtml">     
  
    5. 
  
  
 
   
  5. <head id="Head1" runat="server">     
  
    6. 
  
  
 
   
  6.     <title>jQuery PlugIn - 表单验证插件实例 Validate </title>     
  
    7. 
  
  
 
   
  7.     <!--black-tie,blitzer,blitzer,dot-luv,excite-bike,hot-sneaks,humanity,mint-choc,redmond,smoothness,south-street,start,swanky-purse,trontastic,ui-darkness,ui-lightness,vader-->     
  
    8. 
  
  
 
   
  8.     <link rel="stylesheet" type="text/css" href="<%=WebConfig.ResourceServer +"/JsLib/jquery/themes/redmond/style.css"%>" />     
  
    9. 
  
  
 
   
  9.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/jquery-min-lastest.js"></script>     
  
    10. 
  
  
 
   
  10.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/ui/jquery-ui-all-min-lastest.js"></script>     
  
    11. 
  
  
 
   
  11.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/plugin/jquery.validate/jquery.validate.min.js"></script>     
  
    12. 
  
  
 
   
  12.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/plugin/jquery.validate/localization/messages_cn.js"></script>     
  
    13. 
  
  
 
   
  13.              
  
    14. 
  
  
 
   
  14.     <% if (false)     
  
    15. 
  
  
 
   
  15.        {%><script src="~/js/jquery-vsdoc-lastest.js" type="text/javascript"></script>     
  
    16. 
  
  
 
   
  16.     <% }%>     
  
    17. 
  
  
 
   
  17.     <script type="text/javascript">     
  
    18. 
  
  
 
   
  18.         /*========== 必须放在头部加载的语句块. 尽量避免使用 ==========*/    
  
    19. 
  
  
 
   
  19.     </script>     
  
    20. 
  
  
 
   
  20.     <style type="text/css">     
  
    21. 
  
  
 
   
  21.         body     
  
    22. 
  
  
 
   
  22.         {     
  
    23. 
  
  
 
   
  23.             font-size:12px;     
  
    24. 
  
  
 
   
  24.         }     
  
    25. 
  
  
 
   
  25.         /* form中显示文字的label */    
  
    26. 
  
  
 
   
  26.         .slabel     
  
    27. 
  
  
 
   
  27.         {     
  
    28. 
  
  
 
   
  28.             width:100px;     
  
    29. 
  
  
 
   
  29.             display: -moz-inline-box;     
  
    30. 
  
  
 
   
  30.             line-height: 1.8;     
  
    31. 
  
  
 
   
  31.             display: inline-block;     
  
    32. 
  
  
 
   
  32.             text-align:right;     
  
    33. 
  
  
 
   
  33.         }     
  
    34. 
  
  
 
   
  34.         /* 出错样式 */    
  
    35. 
  
  
 
   
  35.         input.error, textarea.error     
  
    36. 
  
  
 
   
  36.         {     
  
    37. 
  
  
 
   
  37.             border: solid 1px #CD0A0A;     
  
    38. 
  
  
 
   
  38.         }     
  
    39. 
  
  
 
   
  39.         label.error     
  
    40. 
  
  
 
   
  40.         {     
  
    41. 
  
  
 
   
  41.             color:#CD0A0A;     
  
    42. 
  
  
 
   
  42.             margin-left:5px;     
  
    43. 
  
  
 
   
  43.         }     
  
    44. 
  
  
 
   
  44.         /* 深红色文字 */    
  
    45. 
  
  
 
   
  45.         .textred     
  
    46. 
  
  
 
   
  46.         {     
  
    47. 
  
  
 
   
  47.             color:#CD0A0A;     
  
    48. 
  
  
 
   
  48.         }     
  
    49. 
  
  
 
   
  49.     </style>     
  
    50. 
  
  
 
   
  50. </head>     
  
    51. 
  
  
 
   
  51. <body>     
  
    52. 
  
  
 
   
  52.     <form id="commentForm" method="get" action="">     
  
    53. 
  
  
 
   
  53.     <fieldset style="width:500px;"><legend>表单验证</legend>     
  
    54. 
  
  
 
   
  54.         <p><label for="cname" class="slabel"><em class="textred">*</em> 姓名:</label>     
  
    55. 
  
  
 
   
  55.             <input id="cname" name="name" size="25" class="required" minlength="2" />     
  
    56. 
  
  
 
   
  56.         </p>     
  
    57. 
  
  
 
   
  57.         <p><label for="cemail" class="slabel"><em class="textred">*</em> E-Mail:</label>     
  
    58. 
  
  
 
   
  58.             <input id="cemail" name="email" size="25"/>     
  
    59. 
  
  
 
   
  59.         </p>     
  
    60. 
  
  
 
   
  60.         <p><label for="curl" class="slabel">网址:</label>                 
  
    61. 
  
  
 
   
  61.             <input id="curl" name="url" size="25" class="url" value="" />     
  
    62. 
  
  
 
   
  62.         </p>     
  
    63. 
  
  
 
   
  63.         <p><label for="ccomment" class="slabel"><em class="textred">*</em> 内容:</label>     
  
    64. 
  
  
 
   
  64.             <textarea rows="2" id="ccomment" name="comment" cols="20" class="required" style="height:80px;"></textarea>     
  
    65. 
  
  
 
   
  65.         </p>     
  
    66. 
  
  
 
   
  66.         <p style="text-align:center;">     
  
    67. 
  
  
 
   
  67.             <input class="submit" type="submit" value="提交" />     
  
    68. 
  
  
 
   
  68.         </p>     
  
    69. 
  
  
 
   
  69.     </fieldset>     
  
    70. 
  
  
 
   
  70.     </form>     
  
    71. 
  
  
 
   
  71.     <script type="text/javascript">     
  
    72. 
  
  
 
   
  72.        /*==========用户自定义方法==========*/    
  
    73. 
  
  
 
   
  73.     
  
    74. 
  
  
 
   
  74.     
  
    75. 
  
  
 
   
  75.        /*==========事件绑定==========*/    
  
    76. 
  
  
 
   
  76.        $(function()     
  
    77. 
  
  
 
   
  77.        {     
  
    78. 
  
  
 
   
  78.     
  
    79. 
  
  
 
   
  79.        });     
  
    80. 
  
  
 
   
  80.     
  
    81. 
  
  
 
   
  81.        /*==========加载时执行的语句==========*/    
  
    82. 
  
  
 
   
  82.        $(function()     
  
    83. 
  
  
 
   
  83.        {     
  
    84. 
  
  
 
   
  84.            $("#commentForm").validate(     
  
    85. 
  
  
 
   
  85.            {     
  
    86. 
  
  
 
   
  86.                errorClass: "error",     
  
    87. 
  
  
 
   
  87.                submitHandler: function(form)     
  
    88. 
  
  
 
   
  88.                {     
  
    89. 
  
  
 
   
  89.                    //如果想提交表单, 需要使用form.submit()而不要使用$(form).submit()     
  
    90. 
  
  
 
   
  90.                    alert("submitted!");     
  
    91. 
  
  
 
   
  91.                },     
  
    92. 
  
  
 
   
  92.                rules: {     
  
    93. 
  
  
 
   
  93.                    //为name为email的控件添加两个验证方法:required()和email()     
  
    94. 
  
  
 
   
  94.                    email: { required: true, email: true }     
  
    95. 
  
  
 
   
  95.                },     
  
    96. 
  
  
 
   
  96.                messages: {     
  
    97. 
  
  
 
   
  97.                    //为name为email的控件的required()和email()验证方法设置验证失败的消息内容     
  
    98. 
  
  
 
   
  98.                    email: {required:"需要输入电子邮箱", email:"电子邮箱格式不正确"}     
  
    99. 
  
  
 
   
  99.                }     
  
    100. 
  
  
 
   
  100.     
  
    101. 
  
  
 
   
  101.            });     
  
    102. 
  
  
 
   
  102.        });             
  
    103. 
  
  
 
   
  103.     </script>     
  
    104. 
  
  
 
   
  104. </body>     
  
    105. 
  
  
 
   
  105. </html>   
 
    106.

2. 实例讲解

(1) 验证方法

验证方法是验证某一个控件是否满足某些规则的方法, 返回一个boolean值. 比如email( ) 方法验证内容是否符合email格式, 符合则返回true. 下面是类库中email方法的源代码:


  
  1. // http://docs.jquery.com/Plugins/Validation/Methods/email     
  
    2. 
  
  
 
   
  2. email: function(value, element) {     
  
    3. 
  
  
 
   
  3.     // contributed by Scott Gonzalez: http://projects.scottsplayground.com/email_address_validation/     
  
    4. 
  
  
 
   
  4.     return this.optional(element) || /^((([a-z]|\d|[!#\$%&'\*\+\-\/=\?\^_`{\|}~]|   
  
    5. 
  
  
 
   
  5. [\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])+(\.([a-z]|\d|[!#\$%&'\*\+\-\/=\?\^_`{\|}~]|   
  
    6. 
  
  
 
   
  6. [\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])+)*)|((\x22)((((\x20|\x09)*(\x0d\x0a))?(\x20|\x09)+)?   
  
    7. 
  
  
 
   
  7. (([\x01-\x08\x0b\x0c\x0e-\x1f\x7f]|\x21|[\x23-\x5b]|   
  
    8. 
  
  
 
   
  8. [\x5d-\x7e]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|   
  
    9. 
  
  
 
   
  9. (\\([\x01-\x09\x0b\x0c\x0d-\x7f]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF]))))*(((\x20|\x09)*(\x0d\x0a))?(\x20|\x09)+)?   
  
    10. 
  
  
 
   
  10. (\x22)))@((([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|   
  
    11. 
  
  
 
   
  11. (([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|   
  
    12. 
  
  
 
   
  12. \d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.)+(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|   
  
    13. 
  
  
 
   
  13. [\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|   
  
    14. 
  
  
 
   
  14. [\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.?$/i.test(value);     
  
    15. 
  
  
 
   
  15. },   
 
    16.

我们在:http://docs.jquery.com/Plugins/Validation中的 List of built-in Validation methods 一节中列出了所有内置的验证方法. 同时插件还提供了additional-methods.js 文件, 里面包含了更多的验证方法, 引入后既可启用.

(2) 验证消息

验证消息就是验证方法失败后显示的文字内容. 验证消息一定关联在某一个验证方法上, 并且全局的验证消息保存在jQuery.validator.messages 属性中.

默认的validate类库自带英文验证消息:


  
  1. messages: {     
  
    2. 
  
  
 
   
  2.     required: "This field is required.",         
  
    3. 
  
  
 
   
  3.     //...         
  
    4. 
  
  
 
   
  4. });   
 
    5.

上面说明当required验证方法验证失败是, 显示"This field is required."这条消息.

在下载文件的localization文件夹中, 包含了各国语言的基本验证消息, 如同本实例一样引入不同的语言文件即可实现语言切换:


  
  1. <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/plugin/jquery.validate/localization/messages_cn.js"></script>   
 
    2.

语言文件的内容举例:


  
  1. jQuery.extend(jQuery.validator.messages, {     
  
    2. 
  
  
 
   
  2.         required: "必选字段",     
  
    3. 
  
  
 
   
  3.         //...     
  
    4. 
  
  
 
   
  4. });   
 
    5.

现在必填项的问题提示就变成了中文.

除了全局默认的验证消息, 也可以为某一个表单元素设置特有的验证消息, 比如本文实例中, 为email元素设置了特有的验证消息:


  
  1. messages: {     
  
    2. 
  
  
 
   
  2.    //为name为email的控件的required()和email()验证方法设置验证失败的消息内容     
  
    3. 
  
  
 
   
  3.    email: {required:"需要输入电子邮箱", email:"电子邮箱格式不正确"}     
  
    4. 
  
  
 
   
  4. }   
 
    5.

options的messages属性可以针对某一个表单元素设置验证消息, 第一个email表示email元素, 值是一个集合, required就表示required验证函数, 第二个email表示是email验证函数.

(3)验证规则

验证规则就是这样的语意语句: 在元素A上, 使用 验证方法A 和 验证方法B 进行验证.

验证规则将元素与验证方法关联起来, 因为验证方法同时也关联了验证消息, 所以元素与消息也关联了起来.

为一个元素添加验证规则有多种方式.

本实例的"姓名"元素使用了CSS样式规则和元素属性规则:


  
  1. <input id="cname" name="name" size="25" class="required" minlength="2" />   
 
    2.

class元素属性设置元素的CSS样式类, 因为样式类中添加了required类, 所以会和required()验证函数关联. 这种规则叫做CSS样式规则.

minlength元素属性也会自动和minlength()验证函数关联, 这种规则叫做元素属性规则.

另外还可以通过编程的方式进行关联:


  
  1. rules: {     
  
    2. 
  
  
 
   
  2.    //为name为email的控件添加两个验证方法:required()和email()     
  
    3. 
  
  
 
   
  3.    email: { required: true, email: true }     
  
    4. 
  
  
 
   
  4. },   
 
    5.

上面的语句表名为email表单对象添加了required()和email()验证函数.

(4) 表单提交

默认情况下, 当验证函数失败时表单不会提交.

但是可以通过添加class="cancel"的方式让提交按钮跳过验证:


  
  1. <input type="submit" class="cancel" name="cancel" value="Cancel" />   
 
    2.

当表单提交时, 会触发options中submitHandler属性设置的函数:


  
  1. submitHandler: function(form)     
  
    2. 
  
  
 
   
  2. {     
  
    3. 
  
  
 
   
  3.    //如果想提交表单, 需要使用form.submit()而不要使用$(form).submit()     
  
    4. 
  
  
 
   
  4.    alert("submitted!");     
  
    5. 
  
  
 
   
  5. },   
 
    6.

此函数的签名同上. 我们可以在这个函数中, 编写在表单提交前需要处理的业务逻辑.

需要注意当最后以编程的方式提交表单时, 一定不要使用jQuery对象的submit()方法, 因为此方法会触发表单验证,并且再次调用submitHandler设置的函数, 会导致递归调用.

此函数的参数form就是表单对象, 用途就是不进行验证提交表单:form.submit()

(5) DEBUG模式

在开发阶段我们通常不希望表单被真正提交, 虽然可以通过本实例中重写submitHandler函数来实现, 但是还有更好的方式, 我们可以在submitHandler函数完成正式提交的逻辑, 然后通过设置options的debug属性, 来达到即使验证通过也不会提交表单的目的:


  
  1. $(".selector").validate({     
  
    2. 
  
  
 
   
  2.    debug: true    
  
    3. 
  
  
 
   
  3. })   
 
    4.

(6) 多表单验证

有时会在一个页面上出现多个Form, 因为validate控件是针对form对象进行包装的, 所以我们可以控制哪些form对象需要验证.

同时为了方便一次设置页面上所有的应用了validate控件的form对象, 提供了 jQuery.validator.setDefaults 函数让我们可以一次设置所有的默认值:


  
  1. jQuery.validator.setDefaults({      
  
    2. 
  
  
 
   
  2.     debug: true      
  
    3. 
  
  
 
   
  3. });   
 
    4.

二.自动完成插件 autocomplete

autocomplete插件能帮助我们实现类似于Google Suggest的效果:

image

插件首页:

http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete/

插件文档:

http://docs.jquery.com/Plugins/Autocomplete

配置说明:

http://docs.jquery.com/Plugins/Autocomplete/autocomplete#toptions

1.应用实例

本实例演示的是使用autocomplete完成对输入城市的自动提示效果,如图:

image

实例代码:


  
  1. <%@ Page Language="C#" %>     
  
    2. 
  
  
 
   
  2.     
  
    3. 
  
  
 
   
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">     
  
    4. 
  
  
 
   
  4. <html xmlns="http://www.w3.org/1999/xhtml">     
  
    5. 
  
  
 
   
  5. <head id="Head1" runat="server">     
  
    6. 
  
  
 
   
  6.     <title>jQuery PlugIn - 自动完成插件实例 AutoComplete </title>     
  
    7. 
  
  
 
   
  7.     <!--black-tie,blitzer,blitzer,dot-luv,excite-bike,hot-sneaks,humanity,mint-choc,redmond,smoothness,south-street,start,swanky-purse,trontastic,ui-darkness,ui-lightness,vader-->     
  
    8. 
  
  
 
   
  8.     <link rel="stylesheet" type="text/css" href="<%=WebConfig.ResourceServer +"/JsLib/jquery/themes/redmond/style.css"%>" />     
  
    9. 
  
  
 
   
  9.     <link rel="stylesheet" type="text/css" href="<%=WebConfig.ResourceServer +"/JsLib/jquery/plugin/jquery.autocomplete/jquery.autocomplete.css"%>" />     
  
    10. 
  
  
 
   
  10.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/jquery-min-lastest.js"></script>     
  
    11. 
  
  
 
   
  11.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/ui/jquery-ui-all-min-lastest.js"></script>     
  
    12. 
  
  
 
   
  12.     <script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/plugin/jquery.autocomplete/jquery.autocomplete.min.js"></script>     
  
    13. 
  
  
 
   
  13.     <% if (false)     
  
    14. 
  
  
 
   
  14.        {%><script src="~/js/jquery-vsdoc-lastest.js" type="text/javascript"></script>     
  
    15. 
  
  
 
   
  15.     <% }%>     
  
    16. 
  
  
 
   
  16.     <script type="text/javascript">     
  
    17. 
  
  
 
   
  17.         /*========== 必须放在头部加载的语句块. 尽量避免使用 ==========*/    
  
    18. 
  
  
 
   
  18.     </script>     
  
    19. 
  
  
 
   
  19.     <style type="text/css">     
  
    20. 
  
  
 
   
  20.         body     
  
    21. 
  
  
 
   
  21.         {     
  
    22. 
  
  
 
   
  22.             font-size: 12px;     
  
    23. 
  
  
 
   
  23.         }     
  
    24. 
  
  
 
   
  24.              
  
    25. 
  
  
 
   
  25.         .formLabel{float: left; width: 150px; text-align:right;}     
  
    26. 
  
  
 
   
  26.         .formInput{float: left;}     
  
    27. 
  
  
 
   
  27.     </style>     
  
    28. 
  
  
 
   
  28. </head>     
  
    29. 
  
  
 
   
  29. <body>     
  
    30. 
  
  
 
   
  30.     <!-- Demo. 应用AutoComplete插件 -->     
  
    31. 
  
  
 
   
  31.     <div class="ui-widget ui-widget-content ui-corner-all" style="width: 700px; padding: 5px;">     
  
    32. 
  
  
 
   
  32.         <h3>     
  
    33. 
  
  
 
   
  33.             Demo. 应用AutoComplete插件 </h3>     
  
    34. 
  
  
 
   
  34.         <br style="clear: both" />     
  
    35. 
  
  
 
   
  35.         <div class="formLabel">     
  
    36. 
  
  
 
   
  36.             <label for="inputCityName">请输入城市拼音和汉字:</label>     
  
    37. 
  
  
 
   
  37.         </div>     
  
    38. 
  
  
 
   
  38.         <div class="formInput">     
  
    39. 
  
  
 
   
  39.             <input id="inputCityName" name="inputCityName" type="text" />     
  
    40. 
  
  
 
   
  40.         </div>     
  
    41. 
  
  
 
   
  41.         <br style="clear:both" />     
  
    42. 
  
  
 
   
  42.         <br style="clear: both" />     
  
    43. 
  
  
 
   
  43.         <div class="formLabel">     
  
    44. 
  
  
 
   
  44.             <label for="inputCityName">城市ID:</label></div>     
  
    45. 
  
  
 
   
  45.         <div class="formInput">     
  
    46. 
  
  
 
   
  46.             <input id="inputCityId" name="inputCityId" type="text" /></div>     
  
    47. 
  
  
 
   
  47.         <br style="clear: both" />     
  
    48. 
  
  
 
   
  48.         <br style="clear: both" />     
  
    49. 
  
  
 
   
  49.     </div>     
  
    50. 
  
  
 
   
  50.     <script type="text/javascript">     
  
    51. 
  
  
 
   
  51.         /*==========用户自定义方法==========*/    
  
    52. 
  
  
 
   
  52.         //城市数据     
  
    53. 
  
  
 
   
  53.         var cityList;     
  
    54. 
  
  
 
   
  54.         //autocomplete选项     
  
    55. 
  
  
 
   
  55.         var options = {     
  
    56. 
  
  
 
   
  56.             minChars: 1,     
  
    57. 
  
  
 
   
  57.             max: 500,     
  
    58. 
  
  
 
   
  58.             width: 250,     
  
    59. 
  
  
 
   
  59.             matchContains: true,     
  
    60. 
  
  
 
   
  60.             formatItem: function(row, i, max)     
  
    61. 
  
  
 
   
  61.             {     
  
    62. 
  
  
 
   
  62.                 return i + "/" + max + ": \"" + row.CityNameEn + "\" [" + row.CityName + "]";     
  
    63. 
  
  
 
   
  63.             },     
  
    64. 
  
  
 
   
  64.             formatMatch: function(row, i, max)     
  
    65. 
  
  
 
   
  65.             {     
  
    66. 
  
  
 
   
  66.                 return row.CityNameEn + " " + row.CityName;     
  
    67. 
  
  
 
   
  67.             },     
  
    68. 
  
  
 
   
  68.             formatResult: function(row)     
  
    69. 
  
  
 
   
  69.             {     
  
    70. 
  
  
 
   
  70.                 return row.CityName;     
  
    71. 
  
  
 
   
  71.             }                 
  
    72. 
  
  
 
   
  72.         };     
  
    73. 
  
  
 
   
  73.         //autocomplete初始化函数     
  
    74. 
  
  
 
   
  74.         function initAutoComplete(data)     
  
    75. 
  
  
 
   
  75.         {     
  
    76. 
  
  
 
   
  76.             cityList = data;     
  
    77. 
  
  
 
   
  77.             $("#inputCityName").autocomplete(cityList, options);     
  
    78. 
  
  
 
   
  78.             $("#inputCityName").result(function(event, data, formatted)     
  
    79. 
  
  
 
   
  79.             {     
  
    80. 
  
  
 
   
  80.                 $("#inputCityId").val(data.ElongCityId);     
  
    81. 
  
  
 
   
  81.             });                         
  
    82. 
  
  
 
   
  82.         }     
  
    83. 
  
  
 
   
  83.     
  
    84. 
  
  
 
   
  84.     
  
    85. 
  
  
 
   
  85.         /*==========事件绑定==========*/    
  
    86. 
  
  
 
   
  86.         $(function()     
  
    87. 
  
  
 
   
  87.         {     
  
    88. 
  
  
 
   
  88.         });     
  
    89. 
  
  
 
   
  89.     
  
    90. 
  
  
 
   
  90.         /*==========加载时执行的语句==========*/    
  
    91. 
  
  
 
   
  91.         $(function()     
  
    92. 
  
  
 
   
  92.         {     
  
    93. 
  
  
 
   
  93.             //加载城市数据, 并在回调函数中用返回的数据初始化autocomplete     
  
    94. 
  
  
 
   
  94.             $.getJSON("cityinfo.htm", null, initAutoComplete)       
  
    95. 
  
  
 
   
  95.         });             
  
    96. 
  
  
 
   
  96.     </script>     
  
    97. 
  
  
 
   
  97. </body>     
  
    98. 
  
  
 
   
  98. </html>     
  
    99. 
  
  
 
   
  99.      
 
    100.

2. 实例讲解

(1)准备数据源

首先要准备实现自动建议的数据源. 本实例是通过发送Ajax请求获取JSON对象. autocomplete()方法支持两个参数, 第一个是data, 第二个是options.

其中data参数可以使本实例中的一个数据变量, 也可以是一个url. 如果是url则会每次都调用Ajax请求获取数据.

为了效率我倾向于在数据量允许的情况下, 在页面加载后使用Ajax获取全部的数据, 然后使用传递数据变量给autocomplete组件. 如实例中所示. 除非数据特别巨大无法再客户端加载, 则只能每次都使用发送Ajax请求从服务器端获取部分数据. 但是这会对服务器造成负担.

(2) 设置关键函数

虽然options是可选项, 但是对于我们的数据源cityList是一个多属性对象, 所以必须设置下面几个关键的配置项后才能够使用:

formatItem

对匹配的每一行数据使用此函数格式化, 返回值是显示给用户的数据内容.

函数签名:

function(row, rowNum, rowCount, searchItem)

参数说明:

row: 当前行. the results row,

rowNum: 当前行号,从1开始.(注意不是索引,索引从0开始) the position of the row in the list of results (starting at 1),

rowCount: 总的行号 the number of items in the list of results

searchItem: 查询使用的数据, 即formatMatch函数返回的数据格式的内容. 我们在formatMatch函数中会设置程序内部搜索时使用的数据格式,这个格式和给用户展示的数据是不同的.

formatMatch

对每一行数据使用此函数格式化需要查询的数据格式. 返回值是给内部搜索算法使用的. 实例中用户看到的匹配结果是formatItem中设置的格式, 但是程序内部其实只搜索城市的英文和中文名称, 搜索数据在formatMatch中定义:

return row.CityNameEn + " " + row.CityName;

函数签名:

function(row, rowNum, rowCount,)

参数说明同上

formatResult

此函数是用户选中后返回的数据格式. 比如实例中只返回城市名给input控件:

return row.CityName;

函数签名:

function(row, rowNum, rowCount,)

参数说明同上

(3) 为控件添加Result事件函数

上面3个函数无法实现这类要求: 虽然只返回城市名称, 但是查询时使用城市ID, 选中一个城市后需要将城市ID存储在一个隐藏域中.

所以autocomplete控件提供了result事件函数, 此事件会在用户选中某一项后触发:


  
  1. $("#inputCityName").result(function(event, data, formatted)     
  
    2. 
  
  
 
   
  2. {     
  
    3. 
  
  
 
   
  3.     $("#inputCityId").val(data.ElongCityId);     
  
    4. 
  
  
 
   
  4. });    
 
    5.

函数签名:

function(event, data, formatted)

参数列表:

Result事件会为绑定的事件处理函数传递三个参数:

event: 事件对象. event.type为result.

data: 选中的数据行.

formatted: 虽然官方的解释应该是formatResult函数返回的值, 但是实验结果是formatMatch返回的值. 在本实例为: "Beijing 北京".

(4) 匹配中文

当前版本的autocomplete控件对中文搜索存在Bug, 原因是其搜索事件绑定在keydown事件上, 当使用中文输入法输入"北"字时没有任何提示. 我对原库做了修改, 将keydown事件修改为keyup事件, 即可完成对中文的智能提示搜索. 另外主要需要将"matchContains"配置项设置为"true", 因为我们的搜索格式是"Beijing 北京", 默认只匹配开头的字符.

(5) 更多配置项

关于更多的配置项, 请参考官方文档:

http://docs.jquery.com/Plugins/Autocomplete/autocomplete#toptions

(6) 更多事件

除了上面介绍的autocomplete()和result()函数, 还有如下函数:

search( ) : 激活search事件

flushCache( ) : 清空缓存

setOptions( options ) : 设置配置项

三.总结

本文详细介绍了表单验证插件和自动完成插件, 目前大家可以搜索到很多的插件应用, 或者上千的插件列表, 但是却找不到详细的使用文档. 插件用起来简单但是真正的灵活应用却不容易, 除了要翻越英文文档学习基本的使用, 还要花很长时间了解各个参数的作用, 如何配合使用等. 并且在上面做二次开发的难度相对较大, 插件的核心代码多没有注释并且复杂, 要在其中寻找逻辑关系要花费很多时间和精力.

标签
jquery
实战
开发
表单
验证
自动完成
提示插件
易学教程内所有资源均来自网络或用户发布的内容，如有违反法律规定的内容欢迎反馈！
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!