表單驗證是每個網站都躲不掉的工作。資料必須在客戶端與伺服器端各驗證一次:伺服器端是為了安全,客戶端則是為了使用者體驗——沒人喜歡填完二十個欄位、送出後才被告知信箱格式錯誤。
jQuery 的驗證外掛很多,功能大同小異。本文介紹其中歷史最久、生態最完整的一個:jquery.validate。它提供大量可客製的屬性與方法,擴充性良好。
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="jquery.validate.js"></script>
最簡單的版本只需要一個 class:
.error { color: red; margin-left: 8px; }
$(document).ready(function() {
var validator = $("#signupform").validate({
// 驗證規則
rules: {
firstname: "required",
username: { required: true, minlength: 2 },
password: { required: true, minlength: 5 },
password_confirm: {
required: true,
minlength: 5,
equalTo: "#password" // 必須與密碼欄位一致
},
email: { required: true, email: true },
dateformat: "required",
terms: "required"
},
// 對應的錯誤訊息
messages: {
firstname: "姓名不能為空",
username: {
required: "用戶名不能為空",
minlength: jQuery.format("用戶名至少由 {0} 個字元組成")
},
password: {
required: "密碼不能為空",
minlength: jQuery.format("密碼至少由 {0} 個字元組成")
},
password_confirm: {
required: "確認密碼不能為空",
minlength: jQuery.format("確認密碼至少由 {0} 個字元組成"),
equalTo: "密碼與確認密碼不一致"
},
email: { required: "郵箱不能為空", email: "郵箱格式不正確" },
dateformat: "請選擇性別",
terms: " "
},
// 錯誤訊息要放在哪裡:需考慮 table 的欄位結構
errorPlacement: function(error, element) {
if (element.is(":radio")) {
error.appendTo(element.parent().next().next());
} else if (element.is(":checkbox")) {
error.appendTo(element.next());
} else {
error.appendTo(element.parent().next());
}
},
// 全部通過後要執行什麼
submitHandler: function() {
alert("submitted!");
},
// 驗證通過時的樣式處理
success: function(label) {
label.html(" ").addClass("checked");
},
highlight: function(element, errorClass) {
$(element).parent().next().find("." + errorClass).removeClass("checked");
}
});
});
內建規則不夠用時,可以自己擴充:
$.validator.addMethod("checkUserName", function(value) {
// value 為該欄位目前的值
// 在這裡寫你的驗證邏輯,回傳 true / false
return /^[a-zA-Z][a-zA-Z0-9_]{4,15}$/.test(value);
}, '用戶名格式不正確');
使用方式和內建規則完全一樣,只要在 rules 中寫:
rules: {
username: "checkUserName"
}
<form id="signupform" autocomplete="off" method="get" action="">
<table>
<tr>
<td class="label"><label for="firstname">姓名</label></td>
<td class="field"><input id="firstname" name="firstname" type="text" maxlength="100" /></td>
<td class="status"></td>
</tr>
<tr>
<td class="label"><label for="username">用戶名</label></td>
<td class="field"><input id="username" name="username" type="text" maxlength="50" /></td>
<td class="status"></td>
</tr>
<tr>
<td class="label"><label for="password">密碼</label></td>
<td class="field"><input id="password" name="password" type="password" maxlength="50" /></td>
<td class="status"></td>
</tr>
<tr>
<td class="label"><label for="password_confirm">確認密碼</label></td>
<td class="field"><input id="password_confirm" name="password_confirm" type="password" maxlength="50" /></td>
<td class="status"></td>
</tr>
<tr>
<td class="label"><label for="email">郵箱</label></td>
<td class="field"><input id="email" name="email" type="text" maxlength="150" /></td>
<td class="status"></td>
</tr>
<tr>
<td class="label"><label>性別</label></td>
<td class="field" colspan="2">
<input id="sex_men" name="dateformat" type="radio" value="0" />
<label for="sex_men">男</label>
<input id="sex_women" name="dateformat" type="radio" value="1" />
<label for="sex_women">女</label>
</td>
</tr>
<tr>
<td class="label"></td>
<td class="field" colspan="2">
<input id="terms" type="checkbox" name="terms" />
<label for="terms">已閱讀並同意網站條款</label>
</td>
</tr>
<tr>
<td class="label"></td>
<td class="field" colspan="2">
<input id="signupsubmit" name="signup" type="submit" value="註冊" />
</td>
</tr>
</table>
</form>
name 對應 rules 的,只給 id 而不給 name 會直接失效。這是最常見的入門錯誤。