DIV CSS 佈局教程網

jquery.validate.js 使用經驗:規則、遠端驗證與自訂方法
編輯:JQuery特效代碼     

做專案時需要表單驗證,於是用了 jQuery Validate 這個插件。以下把工作中累積的幾個用法記錄下來。

一、前台頁面

<form id="form1" method="post">
 用戶名:<input type="text" id="UserName" name="UserName" />
 <br />
 密 碼:<input type="password" id="Password" name="Password" />
 <br />
 <input type="submit" id="btnRegister" name="btnRegister" value="注冊" />
 <input type="button" id="btnCancel" name="btnCancel" value="取消" />
</form>

name 屬性一定要寫。validate 是靠 name 來對應 rules 與 messages 的設定,少了 name 就不會被驗證,這是最常見的失效原因。

二、JavaScript 設定

<script type="text/javascript">
// 新增自訂驗證方法
jQuery.validator.addMethod("checkPWD", function (value, element) {
    var flag = false;
    // flag = chkpwd($("#pwd"));   // 在這裡寫你的密碼規則邏輯
    return this.optional(element) || flag;
});

$(function () {
    $("#form1").validate({
        rules: {
            UserName: {
                required: true,
                // 遠端驗證:呼叫後端確認名稱是否存在
                remote: {
                    type: "POST",
                    url: "Handler/Handler1.ashx",
                    dataType: "json",
                    data: {
                        action: function () { return "CheckName"; },
                        name:   function () { return $("#UserName").val(); },
                        param1: function () { return "自定義參數1"; }
                    }
                }
            },
            Password: {
                required: true,
                checkPWD: true    // 使用自訂驗證;不需要時改成 false
            }
        },
        messages: {
            "UserName": {
                required: "<span>用戶名不能為空.</span>",
                remote:   "<span>該會員名已存在!</span>"
            },
            "Password": {
                required: "<span>密碼不能為空.</span>",
                checkPWD: "<span>密碼不符合自定義規則.</span>"
            }
        }
    });
});
</script>

三、後端處理程式

public void ProcessRequest(HttpContext context) {
    context.Response.ContentType = "text/plain";
    string action = context.Request["action"];   // 取得動作識別
    string name   = context.Request["name"];     // 取得用戶名
    string param1 = context.Request["param1"];   // 取得自訂參數

    if (!string.IsNullOrEmpty(name)) {
        // 模擬查詢資料庫:若輸入 admin 則視為已存在,回傳 false
        if (name.Equals("admin")) {
            context.Response.Write("false");
        } else {
            context.Response.Write("true");
        }
    }
}

四、執行結果

使用者未輸入資料時:

輸入錯誤資訊時:

幾個實戰要點

remote 的回傳值必須是字串 "true" 或 "false"。回傳 JSON 的 true(布林)在部分版本中會被誤判。最保險的做法是寫 context.Response.Write("true") 這種純文字輸出,並把 contentType 設為 text/plain。

自訂方法的 this.optional(element) 不能省。它的作用是「欄位非必填且為空時直接跳過驗證」。少了這行,空的選填欄位也會被你的規則擋下。

messages 裡可以用 HTML。如上例包了一層 span,方便自訂錯誤訊息的樣式。但要注意這些字串是你自己寫死的,不含使用者輸入,所以安全;不要把後端回傳的使用者內容直接塞進來。

remote 的 data 用函式而非直接取值。寫成 name: function () { return $("#UserName").val(); } 可確保每次驗證都讀取「當前」的值。若寫成 name: $("#UserName").val(),只會在頁面載入時取值一次,之後都不更新。

記得阻止重複送出。validate 會擋下不合規的表單,但通過驗證後仍可能因為使用者連點而重複送出。可以在 submitHandler 裡 disable 送出鈕,或用 $(form).data('submitted', true) 做旗標。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved