本文是介绍两个最常用的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.应用实例

实例效果:

实例代码:

<%@ Page Language="C#" %>  
 
  
  
  
      
      
    " />  
      
      
      
      
          
    <% if (false)  
       {%>  
    <% }%>  
      
        /*========== 必须放在头部加载的语句块. 尽量避免使用 ==========*/ 
      
      
        body  
        {  
            font-size:12px;  
        }  
        /* form中显示文字的label */ 
        .slabel  
        {  
            width:100px;  
            display: -moz-inline-box;  
            line-height: 1.8;  
            display: inline-block;  
            text-align:right;  
        }  
        /* 出错样式 */ 
        input.error, textarea.error  
        {  
            border: solid 1px #CD0A0A;  
        }  
        label.error  
        {  
            color:#CD0A0A;  
            margin-left:5px;  
        }  
        /* 深红色文字 */ 
        .textred  
        {  
            color:#CD0A0A;  
        }  
      
  
  
      
    
表单验证
  
        
* 姓名:  
              
        
  
        
* E-Mail:  
              
        
  
        
网址:              
              
        
  
        
* 内容:  
              
        
  
          
              
        
  
      
      
      
       /*==========用户自定义方法==========*/ 
 
 
       /*==========事件绑定==========*/ 
       $(function()  
       {  
 
       });  
 
       /*==========加载时执行的语句==========*/ 
       $(function()  
       {  
           $("#commentForm").validate(  
           {  
               errorClass: "error",  
               submitHandler: function(form)  
               {  
                   //如果想提交表单, 需要使用form.submit()而不要使用$(form).submit()  
                   alert("submitted!");  
               },  
               rules: {  
                   //为name为email的控件添加两个验证方法:required()和email()  
                   email: { required: true, email: true }  
               },  
               messages: {  
                   //为name为email的控件的required()和email()验证方法设置验证失败的消息内容  
                   email: {required:"需要输入电子邮箱", email:"电子邮箱格式不正确"}  
               }  
 
           });  
       });          
      
  
 

2. 实例讲解

(1) 验证方法

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

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

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

(2) 验证消息

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

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

messages: {  
    required: "This field is required.",      
    //...      
}); 

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

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

语言文件的内容举例:

jQuery.extend(jQuery.validator.messages, {  
        required: "必选字段",  
        //...  
}); 

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

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

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

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

(3)验证规则

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

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

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

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

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

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

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

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

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

(4) 表单提交

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

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

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

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

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

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

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

(5) DEBUG模式

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

$(".selector").validate({  
   debug: true 
}) 

(6) 多表单验证

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

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

jQuery.validator.setDefaults({   
    debug: true   
}); 

二.自动完成插件 autocomplete

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

插件首页:

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

插件文档:

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

配置说明:

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

1.应用实例

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

实例代码:

<%@ Page Language="C#" %>  
 
  
  
  
      
      
    " />  
    " />  
      
      
      
    <% if (false)  
       {%>  
    <% }%>  
      
        /*========== 必须放在头部加载的语句块. 尽量避免使用 ==========*/ 
      
      
        body  
        {  
            font-size: 12px;  
        }  
          
        .formLabel{float: left; width: 150px; text-align:right;}  
        .formInput{float: left;}  
      
  
  
      
      
        
  
            Demo. 应用AutoComplete插件   
          
          
            请输入城市拼音和汉字: