DIV CSS 佈局教程網

jquery.validate 表單驗證的八種常見用法整理
編輯:JQuery入門技巧     

自己從零打造一個通用又完整的表單驗證外掛並不容易。jquery.validate 幾乎能應付九成五以上的驗證情境,值得花點時間把它的用法摸熟。

1. 使用內建規則

直接在 class 上寫規則名稱即可:

 <input id="email" class="required email" value="email@" /> 

2. 在元素上自訂規則

 <input id="complex" value="hi" class="{required:true,minlength:3,maxlength:5,
    messages:{required:'為什麼不輸入一點文字呢',minlength:'輸入的太少了',maxlength:'輸入那麼多幹嘛'}}" /> 

3. 用 JavaScript 定義規則與訊息

 $().ready(function() {
    $("#form2").validate({
        rules: {
            password: { required: true, minlength: 5 },
            confirm_password: { required: true, minlength: 5, equalTo: "#password" }
        },
        messages: {
            password: {
                required: "沒有填寫密碼",
                minlength: jQuery.format("密碼不能小於{0}個字符")
            },
            confirm_password: {
                required: "沒有確認密碼",
                minlength: "確認密碼不能小於{0}個字符",
                equalTo: "兩次輸入密碼不一致嘛"
            }
        }
    });
}); 

required 除了 true/false,也可以傳入運算式或函式,做出條件式必填:

 $("#form2").validate({
    rules: {
        funcvalidate: {
            required: function(){ return $("#password").val() != ""; }
        }
    },
    messages: {
        funcvalidate: { required: "有密碼的情況下必填" }
    }
}); 

對應的 HTML:

 密碼 <input id="password" name="password" type="password" />
確認密碼 <input id="confirm_password" name="confirm_password" type="password" />
條件驗證 <input id="funcvalidate" name="funcvalidate" value="" /> 

4. 用 meta 撰寫驗證資訊

先告訴外掛要讀哪個 meta 名稱:

 $("#form3").validate({ meta: "validate" }); 

HTML 中就能寫成:

 <input class="{validate:{required:true,email:true,
    messages:{required:'輸入 email 地址',email:'你輸入的不是有效的郵件地址'}}}" /> 

5. 把規則寫進自訂屬性

用 $.metadata.setType 指定要讀取的屬性名稱,就能把規則放在自己的標籤裡:

 $().ready(function() {
    $.metadata.setType("attr", "validate");
    $("#form1").validate();
}); 
 <input id="email" name="email"
    validate="{required:true,email:true,
    messages:{required:'輸入 email 地址',email:'你輸入的不是有效的郵件地址'}}" /> 

6. 自訂驗證規則

遇到內建規則應付不來的檢查,用 jQuery.validator.addMethod 擴充。官方提供的 additional-methods.js 收錄了 lettersOnly、zipRange、noWhitespace 等常用規則,可以直接參考。

 jQuery.validator.addMethod("userName", function(value, element) {
    return this.optional(element) || /^[\u0391-\uFFE5\w]+$/.test(value);
}, "用戶名只能包括中文字、英文字母、數字和下劃線");

$("#form1").validate({
    rules: {
        userName: { required: true, userName: true, rangelength: [5, 10] }
    },
    messages: {
        userName: {
            required: "請填寫用戶名",
            rangelength: "用戶名必須在5-10個字符之間"
        }
    }
}); 

7. radio、checkbox 與 select 的驗證

radio:

 <span>
  男 <input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" /><br />
  女 <input type="radio" id="gender_female" value="f" name="gender" />
</span> 

checkbox(至少勾選兩項):

 <span>
  選項1 <input type="checkbox" id="check_1" value="1" name="checkGroup"
    class="{required:true,minlength:2,messages:{required:'必須選擇',minlength:'至少選擇2項'}}" /><br />
  選項2 <input type="checkbox" id="check_2" value="2" name="checkGroup" /><br />
  選項3 <input type="checkbox" id="check_3" value="3" name="checkGroup" /><br />
</span> 

select:

 <span>
  <select id="selectbox" name="selectbox" class="{required:true}">
    <option value=""></option>
    <option value="1">1</option>
    <option value="2">2</option>
  </select>
</span> 

關鍵是同一組的 radio 或 checkbox 必須共用相同的 name,外掛才會把它們視為一體來驗證。

8. Ajax 遠端驗證

 remote: {
    url: "url",
    type: "post",
    dataType: "json",
    data: {
        username: function(){ return $("#username").val(); }
    }
} 

附錄:常用自訂規則集合

實務上這幾個規則幾乎每個專案都會用到,可以整理成一個共用腳本:

 // 手機號碼
jQuery.validator.addMethod("mobile", function(value, element) {
    var mobile = /^(((13[0-9]{1})|(15[0-9]{1}))+\d{8})$/;
    return this.optional(element) || (value.length == 11 && mobile.test(value));
}, "手機號碼格式錯誤");

// 電話號碼
jQuery.validator.addMethod("phone", function(value, element) {
    var tel = /^(0[0-9]{2,3}\-)?([2-9][0-9]{6,7})+(\-[0-9]{1,4})?$/;
    return this.optional(element) || tel.test(value);
}, "電話號碼格式錯誤");

// 郵遞區號
jQuery.validator.addMethod("zipCode", function(value, element) {
    return this.optional(element) || /^[0-9]{6}$/.test(value);
}, "郵遞區號格式錯誤");

// QQ 號
jQuery.validator.addMethod("qq", function(value, element) {
    return this.optional(element) || /^[1-9]\d{4,9}$/.test(value);
}, "QQ 號碼格式錯誤");

// IP 位址
jQuery.validator.addMethod("ip", function(value, element) {
    var ip = /^((?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
    return this.optional(element) || ip.test(value);
}, "IP 位址格式錯誤");

// 英數字
jQuery.validator.addMethod("chrnum", function(value, element) {
    return this.optional(element) || /^([a-zA-Z0-9]+)$/.test(value);
}, "只能輸入數字和字母");

// 中文
jQuery.validator.addMethod("chinese", function(value, element) {
    return this.optional(element) || /^[\u4e00-\u9fa5]+$/.test(value);
}, "只能輸入中文");

// 下拉選單不可停在提示項
$.validator.addMethod("selectNone", function(value, element) {
    return value != "請選擇";
}, "必須選擇一項");

// 位元組長度(中文算 2 個位元組)
jQuery.validator.addMethod("byteRangeLength", function(value, element, param) {
    var length = value.length;
    for (var i = 0; i < value.length; i++) {
        if (value.charCodeAt(i) > 127) { length++; }
    }
    return this.optional(element) || (length >= param[0] && length <= param[1]);
}, $.validator.format("請確保輸入的值在{0}-{1}個位元組之間(一個中文字算2個位元組)")); 

使用心得

這個外掛最實用的設計是「規則與訊息分離」:規則負責判斷,訊息負責說明,兩邊各自獨立設定,畫面文案一改不必動到驗證邏輯。另外記得,前端驗證只是使用者體驗的優化,伺服器端一定要再驗證一次。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved