DIV CSS 佈局教程網

jQuery 表單驗證外掛 validate 完整使用指南
編輯:JavaScript綜合知識     

表單驗證是每個網站都躲不掉的工作。資料必須在客戶端與伺服器端各驗證一次:伺服器端是為了安全,客戶端則是為了使用者體驗——沒人喜歡填完二十個欄位、送出後才被告知信箱格式錯誤。

jQuery 的驗證外掛很多,功能大同小異。本文介紹其中歷史最久、生態最完整的一個:jquery.validate。它提供大量可客製的屬性與方法,擴充性良好。

基本資訊

  • 功能:在客戶端驗證表單,攔下不符合規格的輸入
  • 官方網站:jqueryvalidation.org,有完整的文件與 API 說明
  • 官方範例:官方 demo

使用步驟

1. 引入 jQuery 與外掛

<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="jquery.validate.js"></script>

2. 錯誤訊息樣式

最簡單的版本只需要一個 class:

.error { color: red; margin-left: 8px; }

3. 撰寫驗證規則

$(document).ready(function() {

  var validator = $("#signupform").validate({

    // 驗證規則
    rules: {
      firstname: "required",
      username:  { required: true, minlength: 2 },
      password:  { required: true, minlength: 5 },
      password_confirm: {
        required: true,
        minlength: 5,
        equalTo: "#password"        // 必須與密碼欄位一致
      },
      email: { required: true, email: true },
      dateformat: "required",
      terms: "required"
    },

    // 對應的錯誤訊息
    messages: {
      firstname: "姓名不能為空",
      username: {
        required:  "用戶名不能為空",
        minlength: jQuery.format("用戶名至少由 {0} 個字元組成")
      },
      password: {
        required:  "密碼不能為空",
        minlength: jQuery.format("密碼至少由 {0} 個字元組成")
      },
      password_confirm: {
        required:  "確認密碼不能為空",
        minlength: jQuery.format("確認密碼至少由 {0} 個字元組成"),
        equalTo:   "密碼與確認密碼不一致"
      },
      email: { required: "郵箱不能為空", email: "郵箱格式不正確" },
      dateformat: "請選擇性別",
      terms: " "
    },

    // 錯誤訊息要放在哪裡:需考慮 table 的欄位結構
    errorPlacement: function(error, element) {
      if (element.is(":radio")) {
        error.appendTo(element.parent().next().next());
      } else if (element.is(":checkbox")) {
        error.appendTo(element.next());
      } else {
        error.appendTo(element.parent().next());
      }
    },

    // 全部通過後要執行什麼
    submitHandler: function() {
      alert("submitted!");
    },

    // 驗證通過時的樣式處理
    success: function(label) {
      label.html(" ").addClass("checked");
    },

    highlight: function(element, errorClass) {
      $(element).parent().next().find("." + errorClass).removeClass("checked");
    }
  });
});

自訂驗證方法

內建規則不夠用時,可以自己擴充:

$.validator.addMethod("checkUserName", function(value) {
  // value 為該欄位目前的值
  // 在這裡寫你的驗證邏輯,回傳 true / false
  return /^[a-zA-Z][a-zA-Z0-9_]{4,15}$/.test(value);
}, '用戶名格式不正確');

使用方式和內建規則完全一樣,只要在 rules 中寫:

rules: {
  username: "checkUserName"
}

對應的 HTML

<form id="signupform" autocomplete="off" method="get" action="">
<table>
  <tr>
    <td class="label"><label for="firstname">姓名</label></td>
    <td class="field"><input id="firstname" name="firstname" type="text" maxlength="100" /></td>
    <td class="status"></td>
  </tr>
  <tr>
    <td class="label"><label for="username">用戶名</label></td>
    <td class="field"><input id="username" name="username" type="text" maxlength="50" /></td>
    <td class="status"></td>
  </tr>
  <tr>
    <td class="label"><label for="password">密碼</label></td>
    <td class="field"><input id="password" name="password" type="password" maxlength="50" /></td>
    <td class="status"></td>
  </tr>
  <tr>
    <td class="label"><label for="password_confirm">確認密碼</label></td>
    <td class="field"><input id="password_confirm" name="password_confirm" type="password" maxlength="50" /></td>
    <td class="status"></td>
  </tr>
  <tr>
    <td class="label"><label for="email">郵箱</label></td>
    <td class="field"><input id="email" name="email" type="text" maxlength="150" /></td>
    <td class="status"></td>
  </tr>
  <tr>
    <td class="label"><label>性別</label></td>
    <td class="field" colspan="2">
      <input id="sex_men"   name="dateformat" type="radio" value="0" />
      <label for="sex_men">男</label>
      <input id="sex_women" name="dateformat" type="radio" value="1" />
      <label for="sex_women">女</label>
    </td>
  </tr>
  <tr>
    <td class="label"></td>
    <td class="field" colspan="2">
      <input id="terms" type="checkbox" name="terms" />
      <label for="terms">已閱讀並同意網站條款</label>
    </td>
  </tr>
  <tr>
    <td class="label"></td>
    <td class="field" colspan="2">
      <input id="signupsubmit" name="signup" type="submit" value="註冊" />
    </td>
  </tr>
</table>
</form>

幾個實務上的關鍵點

  • name 屬性不能省。外掛是靠 name 對應 rules 的,只給 id 而不給 name 會直接失效。這是最常見的入門錯誤。
  • radio 與 checkbox 要用陣列式 name。同一群選項若共用一個 name,訊息會重複產生,需要另外處理。
  • 客戶端驗證永遠不能取代伺服器端。使用者可以停用 JavaScript、直接改 DOM,甚至用 curl 繞過整個前端。伺服器端必須把每一條規則重新驗證一次。
  • 密碼強度規則不要只寫 minlength。至少應包含大小寫混雜或數字要求,並在欄位旁即時提示規則,比送出後才報錯友善得多。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved