做專案時需要表單驗證,於是用了 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 就不會被驗證,這是最常見的失效原因。
<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) 做旗標。