我曾經寫過一個基於 jQuery 的表單驗證模組 validator.js,用了一段時間之後發現幾個結構性問題,這裡把整個修正過程記錄下來。
第一版的核心想法,是讓團隊裡不熟 JavaScript 的美工同事也能寫出簡單的驗證規則。以「必填」這個最常見的檢查為例:
function CheckNull(obj, objname){
$(obj).ready(function(){
if (!$(obj).next().is("span")) $(obj).after(" 必填");
});
$(obj).focus(function(){
$(this).next("span").html(objname + "必填");
$(this).next("span").removeClass();
$(this).next("span").addClass("onFocus");
});
$(obj).blur(function(){
if($.trim($(this).val()) != ""){
$(this).next("span").html("已填");
$(this).next("span").removeClass();
$(this).next("span").addClass("onSuccess");
}else{
$(this).next("span").html(objname + "必填");
$(this).next("span").removeClass();
$(this).next("span").addClass("onError");
}
});
}
它處理的是同一個物件的三種狀態:載入完成時自動插入 span 作為提示容器;取得焦點時顯示該欄位的規則;失去焦點時驗證合法性。
呼叫端很直覺:
$(document).ready(function(){
CheckNull(account, "使用者名稱");
});
$("submit").click(function(){
chkfrm(document.form1);
});
function chkfrm(obj){
$("input:text,input:password,select,", obj).each(function(){
$(this).blur();
});
if ($(".onError:first") == null)
obj.submit();
else
$(".onError:first").prev().focus();
}
這個版本在一段時間內確實解決了眼前需求,但持續使用後,問題一個個浮現:
新版本換了完全不同的思路,同時也擺脫了 jQuery。jQuery 很好用,但對這麼簡單的驗證來說,僅為了取元素方便一點而載入整個函式庫,考慮到它的體積,實在有點得不償失——原生 JavaScript 已經夠簡潔了。
function CheckNull(obj, objname)
{
var flag = false;
if (obj.value == null || obj.value == "")
flag = false;
else
flag = true;
if(!flag)
tips(obj); // 顯示錯誤提示
else
clear(obj); // 清除錯誤提示
return flag;
}
現在 CheckNull 只回答一件事:這個欄位是不是空的。它不再決定提示長什麼樣子。呼叫端則把各項驗證的回傳值收集起來:
function chkfrm(obj){
with(obj){
var arr = new Array(
CheckNull(name, "使用者名稱"),
CheckNull(addr, "地址"),
CheckNull(tel, "聯絡電話"),
);
if (arr.join("").indexOf("false") < 0)
submit();
}
}
結構與程式都變得直白,但重點不在短,而在於錯誤呈現全部收攏到 tips() 裡。邏輯關係維持不變的前提下,只要改 tips() 一個函式,就能換一整套呈現方式,設計師因此有了充分選擇空間,模組的靈活性也保住了。後續版本還打算加入 CheckNull(obj, objname, type) 這樣的呼叫形式,在 tips() 內建幾種樣式,讓同一張表單的不同欄位可以有不同風格的提示。
字串長度驗證:CheckSLen(obj, objname, min_len, max_len); 字串空值驗證:CheckNull(obj, objname); 字串相等驗證:CheckEqual(obj1, obj2, obj1name, obj2name); 數字範圍驗證:CheckNumRange(obj, objname, min_value, max_value); Email 格式驗證:CheckEmail(obj, objname); 身分證格式驗證:CheckId(obj, objname); 正則表達式驗證:CheckExpression(obj, objname, expression);
拋磚引玉,希望這個模組能被繼續打磨得更好用。