jQuery Validation Plugin 內置 17 條核心驗證規則,覆蓋表單 90% 以上場景。本文整理為速查表,附參數說明與組合示例。
| # | 規則名 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| 1 | required |
Boolean | 必填字段 | required: true |
| 2 | remote |
String/Object | AJAX 遠程驗證,服務端返回 "true"/"false" | remote: "check.php" 或 {url: "check.php", type: "post"} |
| 3 | email |
Boolean | 合法郵箱格式 | email: true |
| 4 | url |
Boolean | 合法 URL 格式 | url: true |
| 5 | date |
Boolean | 合法日期(IE6 有兼容性問題,慎用) | date: true |
| 6 | dateISO |
Boolean | ISO 日期格式(YYYY-MM-DD 或 YYYY/MM/DD),僅驗證格式不驗證有效性 | dateISO: true |
| 7 | number |
Boolean | 合法數字(負數、小數均可) | number: true |
| 8 | digits |
Boolean | 僅數字(整數) | digits: true |
| 9 | creditcard |
Boolean | 合法信用卡號(Luhn 算法) | creditcard: true |
| 10 | equalTo |
Selector | 值必須與指定字段相同(如確認密碼) | equalTo: "#password" |
| 11 | accept |
String | 文件上傳後綴名驗證(如 "png|jpg|gif") | accept: "image/*" 或 accept: ".pdf,.doc" |
| 12 | maxlength |
Number | 最大字符長度(中文算 1 個字符) | maxlength: 20 |
| 13 | minlength |
Number | 最小字符長度 | minlength: 6 |
| 14 | rangelength |
Array | 長度範圍 [min, max] | rangelength: [6, 20] |
| 15 | range |
Array | 數值範圍 [min, max] | range: [18, 60] |
| 16 | max |
Number | 最大值(數值比較) | max: 100 |
| 17 | min |
Number | 最小值 | min: 1 |
$("#registerForm").validate({
rules: {
username: {
required: true,
minlength: 3,
maxlength: 16,
remote: "/api/check-username"
},
email: {
required: true,
email: true
},
password: {
required: true,
minlength: 8,
// 自定義規則:至少一個大寫、小寫、數字
pattern: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).+$/
},
confirmPassword: {
required: true,
equalTo: "#password"
},
age: {
required: true,
digits: true,
range: [18, 100]
},
avatar: {
accept: "image/jpeg,image/png,image/gif"
}
},
messages: {
username: {
remote: "用戶名已存在"
}
}
});
// 中文姓名
$.validator.addMethod("chineseName", function(value, element) {
return this.optional(element) || /^[\u4e00-\u9fa5]{2,10}$/.test(value);
}, "請輸入 2-10 位中文姓名");
// 手機號(中國大陸)
$.validator.addMethod("mobileCN", function(value, element) {
return this.optional(element) || /^1[3-9]\d{9}$/.test(value);
}, "請輸入合法手機號");
// 身份證號(簡易版)
$.validator.addMethod("idCard", function(value, element) {
return this.optional(element) || /^\d{17}[\dXx]$/.test(value);
}, "請輸入合法身份證號");
rules: {
companyName: {
required: {
depends: function() {
return $("#userType").val() === "company"; // 企業用戶必填
}
}
}
}
$("#form").validate({
ignore: ":hidden:not(.validate-hidden)" // 隱藏域默認不驗證,特定 class 強制驗證
});
submitHandler: function(form) {
$.ajax({
url: $(form).attr("action"),
type: "POST",
data: $(form).serialize(),
success: function(res) {
if (res.success) location.href = res.redirect;
else showError(res.msg);
}
});
return false; // 阻止默認提交
}
// 添加
$("#field").rules("add", { minlength: 5, messages: { minlength: "至少5字符" } });
// 移除
$("#field").rules("remove", "minlength");
rules 對象,不在 HTML 加 class="required"(語義混淆)messages 對象,支持函數動態生成remote 服務端返回 "true"(字符串)表示通過,其他均視為失敗dateISO + 後端邏輯校驗有效性accept 僅客戶端攔截,服務端必須二次驗證 MIME/內容$.validator.setDefaults({...}) 統一全局配置jQuery Validate 的 17 條內置規則構建了表單驗證的基石。熟練掌握規則參數、組合模式、自定義擴展、動態管理,配合 submitHandler、invalidHandler 等回調,即可構建健壯、用戶友好的表單交互體驗。