表單驗證外掛很多,但自己寫一個的價值在於:規則可以直接寫在 HTML 的 class 上,新增欄位時不必再回頭改 JavaScript。這一篇就來做一個這樣的 formCheck。
<style type="text/css">
form { width: 300px; }
label { position: absolute; }
input:not(.submit), textarea { margin-left: 100px; width: 200px; }
.submit { margin-left: 100px; }
.error { border: 1px solid red; }
</style>
</head>
<body>
<form class="formToCheck" id="formToCheck" method="get" action="#">
<fieldset>
<legend>a simple form</legend>
<p><label for="fname">* first name</label>
<input id="fname" class="required" name="fname" /></p>
<p><label for="lname">last name</label>
<input id="lname" name="lname" /></p>
<p><label for="email">* email</label>
<input id="email" name="email" class="required email" /></p>
<p><label for="comment">* comment</label>
<input id="comment" name="comment" class="required" /></p>
<p><input id="submit" type="submit" class="submit" value="submit" /></p>
</fieldset>
</form>
規則一目了然:class="required" 代表必填;class="required email" 代表必填且需符合 email 格式;完全沒有 class 的欄位則不驗證。這種「約定優於設定」的做法,讓 HTML 自己說明意圖。
(function ($) {
$.fn.formCheck = function (options) {
var defaults = { errorClass: 'error' };
var options = $.extend(defaults, options);
return this.each(function () {
var form = $(this);
if (!form.is('form')) { return; } // 不是 form 就什麼都不做
// 攔下 submit,驗證通過才放行
form.submit(function () {
var errorFlag = false;
$(':input', this).each(function (index, item) {
var element = $(item);
element.removeClass(options.errorClass); // 每次先清掉錯誤樣式
// 必填
if (element.hasClass('required') && element.val().length == 0) {
errorFlag = true;
element.addClass(options.errorClass);
}
// 純數字
if (element.hasClass('number') && element.val().length > 0
&& !/^\d+$/.test(element.val())) {
errorFlag = true;
element.addClass(options.errorClass);
}
// email
if (element.hasClass('email') && element.val().length > 0
&& !/^[a-zA-Z0-9._-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}$/.test(element.val())) {
errorFlag = true;
element.addClass(options.errorClass);
}
// 最小長度:寫成 class="min6" 之類的形式
var num = this.className.match(/min(\d+)/i);
if (num && element.val().length < num[1]) {
errorFlag = true;
element.addClass(options.errorClass);
}
});
return !errorFlag; // 回傳 false 即可阻止表單送出
});
});
};
})(jQuery);
呼叫方式極簡:
$(document).ready(function () {
$('.formToCheck').formCheck();
});
這個版本刻意做得很輕:只用一個 errorClass 標記錯誤欄位,不產生任何提示文字。好處是外掛不搶使用者的版面決定權,你要把紅框改成什麼樣子、要在哪裡顯示錯誤訊息,都由 CSS 與你自己的程式決定。
若要擴充,最自然的兩個方向是:一是把規則表抽成陣列,用迴圈驅動而非連續 if,新增驗證類型時不必改動主流程;二是把 min(\d+) 這類「用 class 傳參數」的手法,推廣成 max、pattern 等規則。另外提醒,這個 email 正則的上限是四個字元的網域後綴,在今日已略嫌狹窄,實戰時建議放寬或改用更嚴謹的表達式;而且無論前端寫得多嚴密,後端仍必須重新驗證一次。
完整展示與下載:jQuery.plugin.formcheck。