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