萬盛學電腦網

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

jQuery Validate 默認驗證規則完整速查表

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

常見組合示例

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: "用戶名已存在"
        }
    }
});

2. 自定義規則擴展

// 中文姓名
$.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);
}, "請輸入合法身份證號");

進階用法技巧

1. 條件驗證:depends

rules: {
    companyName: {
        required: {
            depends: function() {
                return $("#userType").val() === "company"; // 企業用戶必填
            }
        }
    }
}

2. 忽略隱藏字段

$("#form").validate({
    ignore: ":hidden:not(.validate-hidden)" // 隱藏域默認不驗證,特定 class 強制驗證
});

3. 提交前異步驗證

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; // 阻止默認提交
}

4. 動態添加/移除規則

// 添加
$("#field").rules("add", { minlength: 5, messages: { minlength: "至少5字符" } });

// 移除
$("#field").rules("remove", "minlength");

最佳實踐建議

  1. 規則聲明式寫在 rules 對象,不在 HTML 加 class="required"(語義混淆)
  2. 錯誤提示統一用 messages 對象,支持函數動態生成
  3. 遠程驗證 remote 服務端返回 "true"(字符串)表示通過,其他均視為失敗
  4. 日期驗證優先用 dateISO + 後端邏輯校驗有效性
  5. 文件上傳 accept 僅客戶端攔截,服務端必須二次驗證 MIME/內容
  6. 大型表單模塊化:$.validator.setDefaults({...}) 統一全局配置

結語

jQuery Validate 的 17 條內置規則構建了表單驗證的基石。熟練掌握規則參數、組合模式、自定義擴展、動態管理,配合 submitHandler、invalidHandler 等回調,即可構建健壯、用戶友好的表單交互體驗。

copyright © 萬盛學電腦網 all rights reserved