傳統表單驗證的做法是為每個欄位寫一段 if-else,欄位一多,驗證用的輔助程式碼就會遠超過真正的業務邏輯,後續維護非常痛苦。這個元件換個思路:把驗證規則寫成自訂屬性掛在標籤上,再用一段通用程式讀取屬性、套用對應的正則,就能大幅減少重複程式碼。
// 支援 type=text、type=checkbox、type=radio、select 標籤驗證 // vld="***" 必填 + 格式驗證 // vld="n***" 選填 + 格式驗證(n 代表 not-required) // err="***" 自訂錯誤訊息 // super="y" 用 <span> 在標籤後追加提示;同一組只需在第一個標籤標記 // len="***" 長度限制,用於 textarea // rig="***" 自訂正確提示訊息 // <input id="***" type="text" vld="***" err="***" super="y" len="***" />
「必填」與「選填」只差一個 n 前綴,這個命名約定讓後面的分派邏輯得以用字串比對完成,不必為每種規則各寫一個函式入口。
$(function () {
var strRegex = {}; // 正則匿名物件
var strError = {}; // 錯誤訊息
var strRight = {}; // 正確訊息
/** 參數配置 start **/
// 非空
strRegex.NoNull = /[^\s]+/;
strError.NoNull = "請填寫內容,如123、中國!";
// 郵箱
strRegex.Email = /^([a-zA-Z0-9_-])+@([a-zA-Z0-9_-])+((\.[a-zA-Z0-9_-]{2,3}){1,2})$/;
strError.Email = "請核對郵箱格式,如china@163.com!";
// 網址
strRegex.Url = /^http:\/\/[A-Za-z0-9]+\.[A-Za-z0-9]+[\/=\?%\-&_~`@[\]\':+!]*([^\"])*$/;
strError.Url = "請核對網址格式,如https://www.poluoluo.com!";
// 賬號
strRegex.An = /^([a-zA-Z0-9]|[_]){6,16}$/;
strError.An = "請核對賬號格式,如china_56!";
// 數字
strRegex.Math = /\d+$/;
strError.Math = "請核對數字格式,如1234!";
// 年齡
strRegex.Age = /^\d{2}$/;
strError.Age = "請核對年齡格式,10~99歲之間!";
// 郵編
strRegex.Post = /^[1-9]\d{5}$/;
strError.Post = "請核對郵編格式,如150001!";
// 電話(手機或市話皆可)
strRegex.Phone = /^((\d{11})|((\d{7,8})|(\d{4}|\d{3})-(\d{7,8})|(\d{4}|\d{3})-(\d{7,8})-(\d{4}|\d{3}|\d{2}|\d{1})|(\d{7,8})-(\d{4}|\d{3}|\d{2}|\d{1})))$/;
strError.Phone = "請核對電話格式,如15546503251!";
// 身份證
strRegex.Card = /^(([1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])((\d{4})|\d{3}[X,x]))|([1-9]\d{5}[1-9]\d{1}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])(\d{3})))$/;
strError.Card = "請核對身份證格式,如230103190001010000!";
// 金錢
strRegex.Price = /^([1-9]\d*|0)(\.\d+)?$/;
strError.Price = "請核對金錢格式,如99.98!";
// 日期(含閏年判斷)
strRegex.Date = /((^((1[8-9]\d{2})|([2-9]\d{3}))([-\/\._])(10|12|0?[13578])([-\/\._])(3[01]|[12][0-9]|0?[1-9])$)|(^((1[8-9]\d{2})|([2-9]\d{3}))([-\/\._])(11|0?[469])([-\/\._])(30|[12][0-9]|0?[1-9])$)|(^((1[8-9]\d{2})|([2-9]\d{3}))([-\/\._])(0?2)([-\/\._])(2[0-8]|1[0-9]|0?[1-9])$)|(^([2468][048]00)([-\/\._])(0?2)([-\/\._])(29)$)|(^([3579][26]00)([-\/\._])(0?2)([-\/\._])(29)$)|(^([1][89][0][48])([-\/\._])(0?2)([-\/\._])(29)$)|(^([2-9][0-9][0][48])([-\/\._])(0?2)([-\/\._])(29)$)|(^([1][89][2468][048])([-\/\._])(0?2)([-\/\._])(29)$)|(^([2-9][0-9][2468][048])([-\/\._])(0?2)([-\/\._])(29)$)|(^([1][89][13579][26])([-\/\._])(0?2)([-\/\._])(29)$)|(^([2-9][0-9][13579][26])([-\/\._])(0?2)([-\/\._])(29)$))/;
strError.Date = "請核對日期格式,如1999.9.9、1999-9-9、1999.09.09!";
// 時間
strRegex.Time = /^([0-9]|[0-1][0-9]|[2][0-3])(:|:)([0-5][0-9])$/;
strError.Time = "請核對時間格式,如23:59!";
strError.Length = "請核對輸入信息長度,長度小於";
strRight.Info = "格式正確!"; // 可設為空
// 下拉框、單個/同組 checkbox 與 radio 的提示文字
strRegex.DDL = "請選擇"; strError.DDL = "請選擇選項";
strRegex.Check = "請選擇"; strError.Check = "請選擇選項";
strRegex.Radio = "請選擇"; strError.Radio = "請選擇選項";
strRegex.CheckGroup = "請選擇"; strError.CheckGroup = "請選擇選項";
strRegex.RadioGroup = "請選擇"; strError.RadioGroup = "請選擇選項";
// 在標籤後面追加的提示元素
var SpanError = "<span class='vldSpanErr'><img src='" + FilePath() + "images/error.gif' /></span>";
var SpanOk = "<span class='vldSpanRig'><img src='" + FilePath() + "images/ok.gif' /></span>";
/** 參數配置 end **/
把規則集中在一處,要新增一種欄位格式時只需加兩行(正則 + 訊息),不必觸碰主流程,這是整個設計最值得學習的地方。
// 回推到最頂層目錄,用來組出圖片路徑
function FilePath() {
var file = "";
var path = window.location.pathname.split('/');
$(path).each(function () { file = "../" + file; });
return file;
}
// 頁面自檢:欄位失焦即驗證
$("#form1 [vld]").blur(function () { RegexGether($(this)); });
// 依 vld 屬性的值分派到對應的驗證函式
function RegexGether($ctrl) {
switch ($ctrl.attr("vld")) {
case "nonull": RegexNull($ctrl); break;
case "age": RegexInputTextAll($ctrl, strRegex.Age, strError.Age); break;
case "nage": RegexInputTextOnly($ctrl, strRegex.Age, strError.Age); break;
case "date": RegexInputTextAll($ctrl, strRegex.Date, strError.Date); break;
case "ndate": RegexInputTextOnly($ctrl, strRegex.Date, strError.Date); break;
case "price": RegexInputTextAll($ctrl, strRegex.Price, strError.Price); break;
case "nprice": RegexInputTextOnly($ctrl, strRegex.Price, strError.Price); break;
case "email": RegexInputTextAll($ctrl, strRegex.Email, strError.Email); break;
case "nemail": RegexInputTextOnly($ctrl, strRegex.Email, strError.Email); break;
case "post": RegexInputTextAll($ctrl, strRegex.Post, strError.Post); break;
case "npost": RegexInputTextOnly($ctrl, strRegex.Post, strError.Post); break;
case "card": RegexInputTextAll($ctrl, strRegex.Card, strError.Card); break;
case "ncard": RegexInputTextOnly($ctrl, strRegex.Card, strError.Card); break;
case "time": RegexInputTextAll($ctrl, strRegex.Time, strError.Time); break;
case "ntime": RegexInputTextOnly($ctrl, strRegex.Time, strError.Time); break;
case "math": RegexInputTextAll($ctrl, strRegex.Math, strError.Math); break;
case "nmath": RegexInputTextOnly($ctrl, strRegex.Math, strError.Math); break;
case "url": RegexInputTextAll($ctrl, strRegex.Url, strError.Url); break;
case "nurl": RegexInputTextOnly($ctrl, strRegex.Url, strError.Url); break;
case "an": RegexInputTextAll($ctrl, strRegex.An, strError.An); break;
case "nan": RegexInputTextOnly($ctrl, strRegex.An, strError.An); break;
case "phone": RegexInputTextAll($ctrl, strRegex.Phone, strError.Phone); break;
case "nphone": RegexInputTextOnly($ctrl, strRegex.Phone, strError.Phone); break;
case "ddl": RegexSelect($ctrl); break;
case "check": RegexInputCheckBoxRadioOnly($ctrl, strError.Check); break;
case "radio": RegexInputCheckBoxRadioOnly($ctrl, strError.Radio); break;
case "checkgroup": RegexInputCheckBoxRadioAll($ctrl, strError.CheckGroup); break;
case "radiogroup": RegexInputCheckBoxRadioAll($ctrl, strError.RadioGroup); break;
}
}
// 非空驗證,通過後再檢查長度
function RegexNull($ctrl) {
if (strRegex.NoNull.test($ctrl.val())) { return RegexLen($ctrl); }
Error($ctrl, strError.NoNull);
return false;
}
// 同一組的 radio / checkbox:至少選一個
function RegexInputCheckBoxRadioAll($ctrl, error) {
if ($ctrl.parent().children(":checked").length == 0) {
if ($ctrl.parent().children().attr("super")) {
// 同組可能有多個 super='y',只取第一個,return false 跳出 each
$ctrl.parent().children("[super='y']").each(function () {
Error($(this), error);
return false;
});
} else {
$ctrl.parent().children("[type='" + $ctrl.attr("type") + "']").each(function () {
Error($(this), error);
});
}
return false;
} else {
if ($ctrl.parent().children().attr("super")) {
$ctrl.parent().children("[super='y']").each(function () { Ok($(this)); return false; });
} else {
$ctrl.parent().children().each(function () { Ok($(this)); });
}
return true;
}
}
// 單個 radio / checkbox
function RegexInputCheckBoxRadioOnly($ctrl, error) {
if (!$ctrl.attr("checked")) { Error($ctrl, error); return false; }
Ok($ctrl);
return true;
}
// select 的選項驗證
function RegexSelect($ctrl) {
if ($ctrl.val() == strRegex.DDL) { Error($ctrl, strError.DDL); return false; }
Ok($ctrl);
return true;
}
// 允許為空的格式驗證
function RegexInputTextOnly($ctrl, Regex, error) {
if (strRegex.NoNull.test($ctrl.val())) { return RegexOtherFormat($ctrl, Regex, error); }
Ok($ctrl);
return true;
}
// 不允許為空的格式驗證
function RegexInputTextAll($ctrl, Regex, error) {
if (strRegex.NoNull.test($ctrl.val())) { return RegexOtherFormat($ctrl, Regex, error); }
Error($ctrl, error);
return false;
}
// 格式比對
function RegexOtherFormat($ctrl, Regex, error) {
if (Regex.test($ctrl.val())) { return RegexLen($ctrl); }
Error($ctrl, error);
return false;
}
// textarea 長度驗證
function RegexLen($ctrl) {
if ($ctrl.attr("len")) {
var error = strError.Length + $ctrl.attr("len") + "字!";
if (parseInt($ctrl.val().length) > parseInt($ctrl.attr("len"))) {
Error($ctrl, error);
return false;
}
}
Ok($ctrl);
return true;
}
// 驗證失敗的顯示方式
function Error($ctrl, error) {
if ($ctrl.attr("err")) { error = $ctrl.attr("err"); } // err 屬性優先於預設訊息
if ($ctrl.attr("super")) {
$ctrl.parent().find("span").remove();
$ctrl.parent().append(SpanError);
$ctrl.parent().find("span").append(error);
$ctrl.parent().find("span").fadeTo("slow", 0.66);
} else {
$ctrl.attr("title", error); // 沒有 super 時退回用 title 顯示
$ctrl.addClass("error");
}
}
// 驗證通過,清除錯誤樣式並顯示正確提示
function Ok($ctrl) {
if ($ctrl.attr("super")) { $ctrl.parent().find("span").remove(); }
else { $ctrl.removeClass("error"); }
if ($.trim($ctrl.val()).length > 0) {
var right = strRight.Info;
if ($ctrl.attr("rig")) { right = $ctrl.attr("rig"); }
if ($ctrl.attr("super")) {
$ctrl.parent().append(SpanOk);
$ctrl.parent().find("span").append(right);
$ctrl.parent().find("span").fadeTo("slow", 0.99).fadeTo("slow", 0.99).fadeTo("slow", 0);
} else {
$ctrl.attr("title", right);
}
}
}
// 提交自檢:任一欄位帶 error 樣式即攔下表單
$("#vldBtn").click(function () {
$("#form1 [vld]").each(function () { RegexGether($(this)); });
if ($("#form1 [vld][class='error']").length > 0) { return false; }
return true;
});
});
<form id="form1">
<ul class="tab_ul">
<li><p>姓名:</p>
<p><input id="name" type="text" vld="nonull" err="okokok!!!" super="y" rig="格式正確" /></p></li>
<li><p>年齡:</p><p><input id="age" type="text" vld="age" /></p></li>
<li><p>日期:</p><p><input id="date" type="text" vld="ndate" /></p></li>
<li><p>金錢:</p><p><input id="price" type="text" vld="nprice" /></p></li>
<li><p>郵箱:</p><p><input id="email" type="text" vld="email" /></p></li>
<li><p>郵編:</p><p><input id="post" type="text" vld="post" /></p></li>
<li><p>電話:</p><p><input id="phone" type="text" vld="phone" len="10" /></p></li>
<li><p>身份證:</p><p><input id="card" type="text" vld="card" /></p></li>
<li><p>時間:</p><p><input id="time" type="text" vld="ntime" /></p></li>
<li><p>數字:</p><p><input id="math" type="text" vld="nmath" /></p></li>
<li><p>網址:</p><p><input id="url" type="text" vld="url" /></p></li>
<li><p>賬號:</p><p><input id="an" type="text" vld="nan" /></p></li>
<li style="height:60px"><p>文本長度限制:</p>
<p><textarea id="len" style="width:300px; height:50px;" len="50" vld="nonull"></textarea></p></li>
<li><p>下拉框:</p>
<p><select id="ddl" vld="ddl"><option>請選擇</option><option value="1">中國</option></select></p></li>
<li><p>方形復選框:</p>
<p><input type="checkbox" id="check1" vld="check" value="1" /><label for="check1">是</label></p></li>
<li><p>圓形復選框:</p>
<p><input type="radio" id="radio1" vld="radio" value="1" /><label for="radio1">是</label></p></li>
<li><p>方形復選框(同組):</p>
<p>
<input type="checkbox" id="Checkbox1" vld="checkgroup" name="dsa" value="1" err="必須選一個" super="y"/><label for="Checkbox1">是</label>
<input type="checkbox" id="Checkbox2" name="dsa" vld="checkgroup" value="1" /><label for="Checkbox2">是</label>
</p></li>
<li><p>圓形復選框(同組):</p>
<p>
<input type="radio" id="radio2" vld="radiogroup" name="asd" value="1" /><label for="radio2">是</label>
<input type="radio" id="radio3" name="asd" vld="radiogroup" value="1" /><label for="radio3">是</label>
</p></li>
<li><input id="vldBtn" type="button" value="確認" /></li>
</ul>
</form>
這套元件的優點很明確:規則與畫面分離。HTML 只負責宣告「這一格要驗什麼」,驗證邏輯全在 JS 裡;新增欄位不必寫任何 JavaScript。對後台的大量表單來說,維護成本降低非常明顯。
幾點值得注意的地方:
vld、err、super 都不是 HTML 標準屬性,日後若要改用前端框架或 HTML5 內建的 required、pattern,需要一併遷移。現代的等效做法是使用 data-* 屬性。children(":checked") 判斷是對的,但整個元件在 $("#form1 [vld]") 的範圍下運作,多個表單並存時要留意 root 選擇器。