市面上不乏表單驗證框架,用起來很方便,但一旦離開這些框架,很多人就會發現自己寫的驗證既凌亂又缺乏章法。本文的目標,就是示範如何從零開始,規劃一套結構清晰、可重複使用的 JavaScript 表單驗證方案。
我們約定驗證結果只有兩種——成功與失敗,並為兩者各準備一個提示方法,再加一個清除提示的方法:
normalMessage: function(jqueryObj, msg) {
var emObj = $(jqueryObj.parent().find('em')[0]);
emObj.empty().append(msg);
},
warningMessage: function(jqueryObj, msg) {
ValidateHelper.clearMessage(jqueryObj);
var emObj = $(jqueryObj.parent().find('em')[0]);
var spanElement = "<span style='color:#FF4C31;'>" + msg + "</span>";
emObj.empty().append(spanElement);
},
clearMessage: function(jqueryObj) {
var emObj = $(jqueryObj.parent().find('em')[0]);
emObj.empty();
},
validateStringValueIsEmpty: function(obj, normalMsg, warningMsg) {
var jqueryObj = $(obj);
ValidateHelper.clearMessage(obj);
if ($.trim(jqueryObj.val()).length == 0) {
ValidateHelper.warningMessage(jqueryObj, warningMsg);
return false;
}
else {
ValidateHelper.normalMessage(jqueryObj, normalMsg);
return true;
}
},
這個方法會在 onblur 事件中被呼叫,共接收三個參數:要驗證的 DOM 或 jQuery 物件、成功提示、失敗提示。內容為空即回傳失敗,否則回傳成功。
initInfo: function() {
var userName = $('#email');
var userPwd = $('#setPwd');
if (!ValidateHelper.validateStringValueIsEmpty(userName, '通過', '不能為空')) {
userName.focus();
return null;
}
if (!ValidateHelper.validateStringValueIsEmpty(userPwd, '通過', '不能為空')) {
userPwd.focus();
return null;
}
var userInfo = {
UserName: userName.val(),
UserPwd: userPwd.val()
};
return userInfo;
},
針對 Email、身分證號、URL、電話等格式,可以另外建立一個 Validation 物件集中放置各類正則,再交給 ValidateHelper 呼叫。以下為幾個常用範例:
var Validation = {
isEmail: function(s) {
var pattern = /^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/;
return pattern.test(s);
},
isMobile: function(value) {
var validateReg = /^1\d{10}$/;
return validateReg.test(value);
},
isPersonalCard: function(value) {
var validateReg = /(^\d{15}$)|(^\d{17}(\d|[A-Za-z]{1})$)/;
return validateReg.test(value);
},
isZip: function(value) {
var validateReg = /^[0-9]{6}$/;
return validateReg.test(value);
}
};
接著只要再包一層驗證函式,就能同時檢查「不為空」與「格式正確」:
validateStringValueForEmail: function(obj, normalMsg, warningMsg) {
var jqueryObj = $(obj);
ValidateHelper.clearMessage(obj);
if (!ValidateHelper.validateStringValueIsEmpty(jqueryObj, "通過", "不能為空")) {
ValidateHelper.warningMessage(jqueryObj, "不能為空");
return false;
}
if (!Validation.isEmail(jqueryObj.val())) {
ValidateHelper.warningMessage(jqueryObj, warningMsg);
return false;
}
else {
ValidateHelper.normalMessage(jqueryObj, normalMsg);
return true;
}
},
最後,把這些方法綁到輸入框的 onblur、把 post() 綁到送出按鈕即可。送出時若任一欄位驗證失敗,就不會真的把資料送到伺服器端,形成一道完整的防線。
<input name="email" type="text" id="email"
onblur="return ValidateHelper.validateStringValueIsEmpty($(this),'通過','不能為空');" /><em></em>
<input name="cardId" type="text" id="cardId"
onblur="return ValidateHelper.validateStringValueForCardID($(this),'通過','身份證格式不正確');" /><em></em>
<input onclick="return ValidateHelper.post();" type="button" id="btnPost" />
這套模式的優點是「提示方法、驗證方法、正則集合」三者職責分明,方便日後擴充與維護。把驗證邏輯集中管理後,無論表單再怎麼增加欄位,都能沿用同一套規則,讓程式碼保持整齊一致。