jQuery Validate 是表單驗證的經典插件,但版本差異大、文檔不全,易踩坑。本文針對 1.13+ 版本,總結常見問題:新版 data-rule/data-msg 寫法、舊版 class/metadata 失效、提示訊息不顯示、表單重複提交等,並給出解決方案。
<form id="registerForm" method="get" action="">
<p>
<label for="cusername">用戶名</label>
<input id="cusername" name="username" type="text"
data-rule-required="true"
data-rule-rangelength="[2,10]"
data-msg-required="用戶名不能為空"
data-msg-rangelength="用戶名長度必須是2到10個字符" />
</p>
<p>
<label for="cpassword">密碼</label>
<input id="cpassword" name="password" type="password"
data-rule-required="true"
data-rule-minlength="6"
data-msg-required="密碼不能為空"
data-msg-minlength="至少設置6位密碼" />
</p>
<p>
<label for="cconfirmpassword">確認密碼</label>
<input id="cconfirmpassword" name="confirmpassword" type="password"
data-rule-equalTo="#cpassword"
data-msg-equalTo="兩次密碼不一致" />
</p>
<p>
<label for="cemail">郵箱</label>
<input id="cemail" name="email" type="email"
data-rule-required="true"
data-rule-email="true"
data-msg-required="郵箱不能為空"
data-msg-email="郵箱格式不正確" />
</p>
<p>
<label for="chasreferee">有推薦人請勾選</label>
<input type="checkbox" id="chasreferee" name="hasreferee" />
</p>
<p>
<label for="creferee">推薦人</label>
<input id="creferee" name="referee" type="text"
data-rule-required="#chasreferee:checked"
data-msg-required="推薦人不能為空" />
</p>
<p><input type="submit" value="提交"></p>
</form>
<script>
$('#registerForm').validate(); // 自動讀取 data-rule/data-msg
</script>
優點: 無需 jquery.metadata.js、規則與提示寫在元素上、語意化、易維護。
<!-- 舊寫法,新版不支援 -->
<input name="email" validate="{required:true, email:true, messages:{required:'請輸入email', email:'格式錯誤'}}" />
<script>
$.metadata.setType('attr', 'validate');
$('#signupForm').validate({ meta: 'validate' });
</script>
報錯:Cannot read property 'call' of undefined。原因:新版移除對 metadata 格式的內建支援,若必須用舊寫法需額外引入兼容插件,不建議。
原因: 表單被 submit() 觸發兩次 (如 JS 中手動 $form.submit() 且按鈕為 type="submit"),導致驗證流程被打斷,錯誤訊息元素尚未插入即跳轉/重載。
解決: 確保只提交一次,或在 submitHandler 中處理 AJAX 提交並 return false 阻止原生提交。
$('#form').validate({
submitHandler: function (form) {
$.ajax({ url: form.action, type: 'post', data: $(form).serialize(), success: function (res) { ... } });
return false; // 阻止預設提交
}
});
$('#form').validate({
errorPlacement: function (error, element) {
// 預設插在 element 後,可自定義
error.appendTo(element.closest('.form-group').find('.error-container'));
}
});
// 新增 input 後
var $newInput = $('');
$('#form').append($newInput);
// 必須告知 validator 新增元素
$('#form').validate().element($newInput); // 或重新 validate()
data-rule-*/data-msg-* HTML5 寫法。jquery.metadata.js,不要用 class 或 validate 屬性存放規則 JSON。submitHandler 中做 AJAX,返回 false 阻止原生提交。validator.element(newEl) 或 validator.destroy() 後重新 .validate()。errorPlacement、highlight/unhighlight、success 回調自定義 UI 反饋。