萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Validation 表單驗證完全指南:從入門到自定義規則

插件優勢

  • 豐富內置規則:required、email、url、date、number、range、minlength 等
  • 支持異步遠程驗證
  • 高度可定製:錯誤提示位置、樣式、觸發時機
  • 兼容 IE6+、現代瀏覽器

快速開始

1. 引入文件

<script src="js/jquery.js"></script>
<script src="js/jquery.validate.js"></script>
<!-- 可選:額外規則庫 -->
<script src="js/additional-methods.js"></script>

2. 關鍵 CSS(錯誤/成功圖標)

label.error { color:#ea5200; margin-left:4px; padding:0 20px; background:url(images/unchecked.gif) no-repeat 2px 0; }
label.valid { margin-left:4px; padding-left:20px; background:url(images/checked.gif) no-repeat 2px 0; }

3. 表單 HTML(關鍵:name 屬性必須)

<form id="myform" action="#" method="post">
  <input type="text" name="user" id="user" class="input required" />
  <input type="password" name="pass" id="pass" class="input required" />
  <input type="password" name="repass" class="input required" />
  <input type="email" name="email" class="input email" />
  <input type="tel" name="mobile" class="input" />
  <button type="submit">提交</button>
</form>

4. JS 初始化與規則配置

$(function() {
  var validator = $('#myform').validate({
    // 規則:key=字段name,value=規則對象/字符串
    rules: {
      user: {
        required: true,
        minlength: 3,
        maxlength: 16,
        remote: { url: '/api/checkUser', type: 'post', data: { user: function() { return $('#user').val(); } } }
      },
      pass: { required: true, minlength: 6, maxlength: 16 },
      repass: { required: true, equalTo: '#pass' },
      email: { required: true, email: true },
      mobile: { required: true, isMobile: true } // 自定義規則
    },
    // 提示信息
    messages: {
      user: { required: '用戶名不能為空', remote: '該用戶名已存在' },
      pass: { required: '請輸入密碼', minlength: '至少6位' },
      repass: { equalTo: '兩次密碼不一致' }
    },
    // 錯誤提示位置定製
    errorPlacement: function(error, element) {
      error.insertAfter(element); // 默認行為
    },
    // 提交處理
    submitHandler: function(form) {
      $.ajax({ url: form.action, type: 'post', data: $(form).serialize(), dataType: 'json' })
        .done(function(res) { if (res.code===0) location.href=res.url; else alert(res.msg); });
      return false; // 阻止默認提交
    }
  });
});

常用內置規則速查表

規則說明示例
required必填required: true
remote異步驗證remote: '/check'
minlength/maxlength長度範圍minlength: 6
rangelength長度區間rangelength: [3,16]
range數值區間range: [10, 100]
email郵箱格式email: true
urlURL 格式url: true
dateISOISO 日期dateISO: true
digits純數字digits: true
accept文件後綴accept: 'jpg|png|gif'
equalTo與某字段相等equalTo: '#pass'

自定義規則擴展

// 手機號
$.validator.addMethod('isMobile', function(value, element) {
  var mobile = /^1[3-9]\d{9}$/;
  return this.optional(element) || mobile.test(value);
}, '請輸入正確手機號');

// 身份證(簡化版)
$.validator.addMethod('isIdCardNo', function(value, element) {
  var idCard = /(^\d{15}$)|(^\d{18}$)|(^\d{17}[\dXx]$)/;
  return this.optional(element) || idCard.test(value);
}, '身份證號碼格式錯誤');

// IP 地址
$.validator.addMethod('ip', function(value, element) {
  var ip = /^(\d{1,3}\.){3}\d{1,3}$/;
  return this.optional(element) && ip.test(value) && value.split('.').every(n => n <= 255);
}, 'IP 格式錯誤');

常見問題解決

  1. 中文用戶名 remote 驗證亂碼:前端 encodeURIComponent(val),後端 urldecode。
  2. 隱藏域不驗證:默認忽略 :hidden,設置 ignore: [] 或 ignore: ':hidden:not(.validate-hidden)'。
  3. 動態添加字段:validator.element('#newField') 手動觸發,或重新 $('#form').validate()。
  4. 提交按鈕防重複點擊:submitHandler 中禁用按鈕 $(btn).prop('disabled', true)。

總結

jQuery Validation 以「配置代替代碼」的聲明式風格,配合強大的擴展機制,能覆蓋 95% 以上的表單驗證需求。掌握 rules/messages/addMethod 三板斧,即可應對絕大多數項目實戰。

copyright © 萬盛學電腦網 all rights reserved