表單驗證幾乎每個專案都要寫一次,而每寫一次就重複一次。與其到處複製貼上,不如把規則抽成一套「用 class 宣告、由程式統一讀取」的通用機制。以下這份封裝示範了如何用 jQuery 做到這件事。
核心精神是:驗證規則寫在 HTML 上,邏輯寫在 JavaScript 裡。當同一頁有多個 form 需要送出時,程式能準確判斷「目前這個按鈕」該檢查哪些欄位,不會互相干擾。
class="form"class="check"class="confirm",並用 title 放提示文字class="notnull",搭配 nullmsg="xx不能為空!"class="need",搭配型別 class(如 num)與 logicmsg 提示class="errorMessage";訊息文字:class="warn"class="select";核取方塊必選:class="checkbox"若不想走型別對應,也可以直接在欄位上自訂屬性 regex="/^\d+$/",交給程式用正則表達式判斷。
驗證通過後要做什麼,交給外部決定:Global.submitCallback 負責送出後的回呼,Global.confirmCallback 負責刪除確認後的回呼。
function Global() {
var _self = this;
}
Global.submitCallback = null;
Global.confirmCallback = null;
$(document).ready(function () {
// 為每一個表單容器掛上點擊攔截
$("body").find(".form").each(function () {
this.onclick = function (e) {
var button = null;
try {
button = e.srcElement == null ? document.activeElement : e.srcElement;
} catch (ex) {
console.log(ex.message);
button = document.activeElement;
}
if ($(button).is(".check")) { // 送出
var sub = (checkform(this) && CheckInputRex(this)
&& checkselect(this) && checkChecked(this));
if (sub) {
Global.submitCallback.call(this, [e]);
}
return sub;
} else if ($(button).is(".confirm")) { // 刪除確認
var sub = confirm($(button).attr("title"));
if (sub) {
Global.confirmCallback.call(this, [e]);
}
return sub;
} else {
return true;
}
}
});
/* 檢查必填欄位 */
function checkform(form) {
var b = true;
$(form).find(".notnull").each(function () {
if ($.trim($(this).val()).length <= 0) {
$(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
$(this).parents(".form").find(".errorMessage").show();
$(this).select();
$(this).focus();
return b = false;
}
});
if (b == true) {
$(form).find(".warn").text("");
$(form).find(".errorMessage").hide();
}
return b;
}
/* 檢查必選的下拉選單 */
function checkselect(form) {
var b = true;
$(form).find(".select").each(function (i) {
var ck = $(this).find('option:selected').text();
if (ck.indexOf("選擇") > -1) {
$(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
$(this).parents(".form").find(".errorMessage").show();
$(this).focus();
return b = false;
}
});
return b;
}
/* 檢查必選的核取方塊 */
function checkChecked(form) {
var b = true;
$(form).find(".checkbox").each(function (i) {
if (!$(this)[0].checked) {
$(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
$(this).parents(".form").find(".errorMessage").show();
$(this).focus();
return b = false;
}
});
return b;
}
/* 正則比對,失敗時顯示提示 */
function GetFlase(value, reg, ele) {
if (reg.test(value)) {
return true;
}
$(ele).parents(".form").find(".warn").text($(ele).attr("logicmsg"));
$(ele).parents(".form").find(".errorMessage").show();
$(ele).focus();
$(ele).select();
return false;
}
/* 依欄位自訂的 regex 屬性做格式檢查 */
function CheckInputRex(form) {
var b = true;
$(form).find("input[type='text']").each(function () {
if (typeof ($(this).attr("regex")) == 'string') {
if ($.trim($(this).val()).length > 0 && $(this).val() != this.defaultValue) {
var value = $(this).attr("value") || $(this).val();
var regx = eval($(this).attr("regex"));
return b = GetFlase(value, regx, this);
}
}
});
return b;
}
});
原始版本還附帶一個以 switch 對應型別的 CheckInput(),內含手機號、信箱、身份證字、郵遞區號、護照號碼、銀行帳號等大量正則規則,但作者已標註為廢棄方法,改用上面的 regex 屬性寫法即可彈性覆蓋所有情境。
<form class="form">
<input type="text" class="notnull" nullmsg="姓名不能為空!" />
<input type="text" class="num" logicmsg="年齡只能是數字" regex="/^\d+$/" />
<select class="select" nullmsg="請選擇地區">
<option>--請選擇--</option>
<option>台北</option>
</select>
<div class="errorMessage" style="display:none">
<span class="warn"></span>
</div>
<input type="button" class="check" value="送出" />
</form>
.form 容器為範圍。這樣封裝之後,表單驗證就從「每次重寫」變成「掛上 class 即可」。