本文將透過實例講解 jQuery Validate 外掛的功能與用法,分享給大家參考。
前言:對於表單內容格式的驗證,若用原生 JS 撰寫會相當繁瑣。筆者曾在做一個註冊界面時,為了驗證郵箱格式、用戶名格式與密碼格式,四處使用正則,就連錯誤提示資訊也得靠 display:none 來顯示隱藏;自從用了 jQuery Validate 外掛後,開發速度大幅提升。
1. jQuery Validate 提供了強大的驗證功能,官網為 https://jqueryvalidation.org/,站上有詳細的說明文件。使用步驟如下:
(1)先下載 jquery.validate.js 外掛,然後在 HTML 檔中引入:
<script type="text/JavaScript" src="js/jquery-1.11.3.js"></script> <script type="text/javascript" src="js/jquery.validate.js"></script> <script type="text/javascript" src="js/js1.js"></script>
由於 jQuery 外掛是建構在 jQuery 庫之上的,因此在引入 jquery.validate.js 之前,一定要先引入 jQuery.js。
(2)jQuery Validate 提供了 $(form).validate(options) 方法,本身內建必填、數字、文字等驗證規則。其中 form 表示表單元素名稱,options 是調用 validate 方法時的設定物件,所有設定資訊與異常資訊顯示的規則都包含在 options 之中。
2. 使用 jQuery Validate 的方式有很多種,這裡詳細介紹透過表單元素名稱來關聯驗證規則的寫法,這種方式讓行為與結構分離,較為優雅。
<form id="form-sp"> <fieldset> <legend>用戶登錄</legend> <p> <label for="username">用戶名</label> <input type="text" name="username" /> </p> <p class="tip"></p> <p> <label for="password">密 碼</label> <input type="password" name="password"/> </p> <p class="tip"></p> <p> <label for="confirm-password">再輸入</label> <input type="password" name="confirm-password"/> </p> <p class="tip"></p> <label for="verify"></label> <input type="button" value="確定" name="verify" id="btn-ver"/> </fieldset> </form>
針對上述的 HTML,我們可以寫成如下的驗證規則:
$("#form-sp").validate({ rules:{ username:{ required:true, minlength:3 }, password:{ required:true, minlength:6 }, "confirm-password":{ required:true, equalTo:"#password" } }, messages:{ username:{ required:"請輸入你的用戶名", minlength:"至少輸入三位的用戶名" } }, errorPlacement:function(error,element){ error.appendTo(element.parent().next()); } })
運行這段程式碼後,顯示如下:

可以發現,在自訂規則之後,表單就具備了驗證能力。以下來看 validate 物件中幾個屬性的作用:
(1)首先在 rules 屬性中,我們依表單的 name 來確定各元素的規則。例如 required:true 表示該元素不能為空;minlength:2 表示至少 2 位字元;maxlength:10 表示至多 10 位字元。
(2)其次在 messages 屬性中,定義當表單資訊不符合規則時的錯誤提示,若不修改則預設為英文提示。
3. 了解 rules 與 messages 這兩個基本屬性後,以下列出 jQuery Validate 預設提供的校驗規則:
1 required:true 必須輸入的字段。 2 remote:"check.php" 使用 ajax 方法調用 check.php 驗證輸入值。 3 email:true 必須輸入正確格式的電子郵件。 4 url:true 必須輸入正確格式的網址。 5 date:true 必須輸入正確格式的日期。日期校驗 ie6 出錯,慎用。 6 dateISO:true 必須輸入正確格式的日期(ISO),例如:2009-06-23,1998/01/22。只驗證格式,不驗證有效性。 7 number:true 必須輸入合法的數字(負數,小數)。 8 digits:true 必須輸入整數。 9 creditcard: 必須輸入合法的信用卡號。 10 equalTo:"#field" 輸入值必須和 #field 相同。 11 accept: 輸入擁有合法後綴名的字串(上傳文件的後綴)。 12 maxlength:5 輸入長度最多是 5 的字串(漢字算一個字元)。 13 minlength:10 輸入長度最小是 10 的字串(漢字算一個字元)。 14 rangelength:[5,10] 輸入長度必須介於 5 和 10 之間的字串(漢字算一個字元)。 15 range:[5,10] 輸入值必須介於 5 和 10 之間。 16 max:5 輸入值不能大於 5。 17 min:10 輸入值不能小於 10。
以下挑兩個較有意思的規則來分析:
(1)equalTo,用法為 equalTo:"#field",只有當前元素的值與 name 為 field 的元素值相等時才回傳 true,否則報錯。常見於註冊界面驗證兩次密碼是否一致:
<p> <label for="password">密 碼</label> <input type="password" name="password"/> </p> <p class="tip"></p> <p> <label for="confirm-password">再輸入</label> <input type="password" name="confirm-password"/> </p>
對應的驗證規則:
rules:{ username:{ required:true, minlength:3 }, password:{ required:true, minlength:6 }, "confirm-password":{ required:true, equalTo:"#password" } },
只有當 name=confirm-password 的元素與 name=password 的元素值相等時才不會報錯。
(2)email 校驗元素,用於驗證郵箱格式。只要在規則中加入 email:true,就會自動驗證輸入是否符合郵箱格式,若不符則回傳 false 並顯示錯誤提示。

4. validate 的其他方法:
(1)用其他方法代替預設的 submit 方法:
submitHandler:function(form){ form.submit(); } submitHandler:function(form){ form.ajaxsubmit(); }
並且可以改變 validate() 物件的預設 submit 方法:
$.validate.setDefaults({ submitHander:function(form){ form.submit(); } })
(2)debug:只驗證不提交表單。若 debug:true,則表單只驗證不會提交:
$.validate.setDefaults({ debug:true; })
(3)更改錯誤資訊的顯示位置:
errorPlacement:function(error,element){ //第一個參數為錯誤提示信息,第二個參數為HTML中的元素 error.appendTo(element.parent()) //這裡也可以直接寫成類名的形式或者id名的形式 //error.appendTo(".class")或者error.appendTo("#id"); }
此外還有幾個常用設定:errorClass 用來指定錯誤提示的 CSS 類名;errorElement 用來指定標記錯誤的標籤,預設是 label,可改成 em;errorContainer 用來顯示或隱藏驗證資訊;errorLabelContainer 可把錯誤資訊統一放在一個容器裡;wrapper 則用來把 errorElement 再包一層。
希望本文所述對你的 jQuery 程式設計有所幫助。