萬盛學電腦網

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

jQuery Validation 插件擴充:身分證、護照、電話、Email 自訂驗證規則

前言

jQuery Validation 是表單驗證標準庫。本文示範如何透過 `$.validator.addMethod()` 新增台灣身分證、護照號碼、電話、Email 等本地化驗證規則,並整合 Bootstrap Tooltip 風格顯示。

引入檔案

<script src="jquery.js"></script>
<script src="jquery.validate.js"></script>
<script src="additional-methods.js"></script> <!-- 官方額外規則 -->

自訂驗證規則實作

<script>
$(function() {
  // 1. 中英數字底線
  $.validator.addMethod('stringCheck', function(value, element) {
    return this.optional(element) || /^[\u4e00-\u9fa5\w]+$/.test(value);
  }, '只能包含中文、英文、數字、底線');

  // 2. 位元組長度 (中文算 2 碼)
  $.validator.addMethod('byteRangeLength', function(value, element, param) {
    const len = [...value].reduce((sum, ch) => sum + (ch.charCodeAt(0) > 127 ? 2 : 1), 0);
    return this.optional(element) || (len >= param[0] && len <= param[1]);
  }, $.validator.format('請輸入 {0}-{1} 個位元組 (中文算2碼)'));

  // 3. 台灣身分證字號
  $.validator.addMethod('isIdCardNo', function(value, element) {
    if (this.optional(element)) return true;
    if (!/^[A-Z][12]\d{8}$/i.test(value)) return false;
    const letters = 'ABCDEFGHJKLMNPQRSTUVXYWZIO';
    const nums = '1011121314151617181920212223242526272829303132';
    const c = value.charAt(0).toUpperCase();
    const n = letters.indexOf(c) + 10;
    const sum = Math.floor(n/10) + (n%10)*9;
    for (let i=0; i<8; i++) sum += parseInt(value.charAt(i+1)) * (8-i);
    sum += parseInt(value.charAt(9));
    return sum % 10 === 0;
  }, '身分證字號格式錯誤');

  // 4. 護照號碼 (簡易版)
  $.validator.addMethod('passport', function(value, element) {
    return this.optional(element) || /^[A-Z0-9]{6,9}$/i.test(value);
  }, '護照號碼格式錯誤');

  // 5. 台灣手機號碼
  $.validator.addMethod('mobileTW', function(value, element) {
    return this.optional(element) || /^09\d{8}$/.test(value);
  }, '請輸入正確手機號碼 (09xxxxxxxx)');

  // 6. Email (內建 email 規則通常足夠,此為加強版)
  $.validator.addMethod('emailFull', function(value, element) {
    return this.optional(element) || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
  }, '請輸入有效 Email');

  // 表單初始化
  $('#commentForm').validate({
    rules: {
      username: { required: true, stringCheck: true, byteRangeLength: [2, 30] },
      email: { required: true, emailFull: true },
      card: { required: true, isIdCardNo: true },
      passport: { required: true, passport: true },
      phone: { required: true, mobileTW: true }
    },
    errorPlacement: function(error, element) {
      // Bootstrap Tooltip 風格
      element.tooltip({ title: error.text(), trigger: 'manual', placement: 'right' }).tooltip('show');
    },
    success: function(label, element) {
      $(element).tooltip('hide');
    }
  });
});
</script>

HTML 表單結構

<form id="commentForm" class="cmsform">
  <p><label>姓名</label> <input name="username"></p>
  <p><label>Email</label> <input name="email"></p>
  <p><label>身分證</label> <input name="card"></p>
  <p><label>護照</label> <input name="passport"></p>
  <p><label>手機</label> <input name="phone"></p>
  <button type="submit">送出</button>
</form>

身分證字號演算法說明

  1. 英文字母對應數值:A=10, B=11, ..., Z=33 (I, O, Q 除外)。
  2. 十位數×1 + 個位數×9 + 八位數字分別×8~1 + 檢查碼×1。
  3. 總和 % 10 === 0 為合法。

總結

jQuery Validation 擴充性極高,`addMethod` 讓本地化驗證輕鬆接入。配合 `errorPlacement` 可整合任何 UI 框架(Bootstrap Tooltip, SweetAlert, 自訂元件)。新專案亦可考慮 VeeValidate (Vue)、React Hook Form + Zod 等現代方案。

copyright © 萬盛學電腦網 all rights reserved