不管是動態網站還是其他 B/S 架構的系統,都離不開表單。表單作為客戶端向伺服器提交資料的載體,角色舉足輕重——而這立刻帶出一個問題:使用者送出的資料合法嗎?
於是每個專案都要寫一大堆驗證函式,開新專案再寫一次,然後再除錯一次。本文要談的是怎麼把這件事做成一次性的投資。
我的看法是,表單驗證其實有兩個職責:
只做到第一點的驗證,使用者只會看到表單沒反應,然後-repeat 三次後離開。因此通用函式需提供三個能力:取值 GetValue(el)、驗證 CheckForm(oForm)、以及錯誤時的提示與回焦 GoBack(el)。
IE 支援自訂屬性,這是整個方案的基礎。我們可以在每個表單元素上描述自己的規則, conceptually 很接近 XML 的思路:
check 屬性:存放該欄位合法性的正規表達式。warning 屬性:存放驗證失敗時的提示訊息。觸發點是表單的 onsubmit,寫法必須是 return CheckForm(this)——少寫 return 就前功盡棄。
<form onsubmit="return CheckForm(this)">
整體流程因此非常清爽:讀取表單元素的 check 屬性取得字串,據此建構 RegExp,拿來比對欄位值;通過就放行,失敗則讀取 warning 屬性彈出提示並把焦點移回該欄位。剩下的工作,就是把正規表達式寫好。
依行為共性可分三大類:
一、文字輸入類(直接取 el.value)
<input type="text" name="txt"> <input type="password" name="pwd"> <input type="hidden" name="hid"> <input type="file" name="myfile"> <textarea name="txts"></textarea>
二、核取與單選類(同一 name 構成一組,需回傳「選了幾個」)
<input type="checkbox" name="c"> <input type="radio" name="r">
三、下拉選單類
<select name="sel"></select> <select name="sels" multiple></select>
/*
* 客戶端表單通用驗證 CheckForm(oForm)
*
* 使用:
* <form name="form1" onsubmit="return CheckForm(this)">
* <input type="text" name="id"
* check="^\S+$" warning="帳號不能為空,且不能含有空格">
* <input type="submit">
* </form>
*
* 注意:撰寫正規表達式時務必嚴謹,別讓人有可乘之機。
*/
// 主函式:遍歷所有表單元素
function CheckForm(oForm) {
var els = oForm.elements;
for (var i = 0; i < els.length; i++) {
if (els[i].check) { // 需要驗證
var sReg = els[i].check; // 正規表達式字串
var sVal = GetValue(els[i]); // 通用取值
var reg = new RegExp(sReg, "i"); // 不區分大小寫
if (!reg.test(sVal)) {
alert(els[i].warning); // 顯示提示
GoBack(els[i]); // 回焦
return false; // 阻止提交
}
}
}
return true;
}
// 通用取值:分三類處理
function GetValue(el) {
switch (el.type) {
case "text":
case "hidden":
case "password":
case "file":
case "textarea":
return el.value;
case "checkbox":
case "radio":
return GetValueChoose(el);
case "select-one":
case "select-multiple":
return GetValueSel(el);
}
return "";
// 以 "0" 表示一個被選中的項目,撰寫正規式時可用 0{2,} 表示至少選兩項
function GetValueChoose(el) {
var sValue = "";
var group = document.getElementsByName(el.name);
for (var i = 0; i < group.length; i++) {
if (group[i].checked) sValue += "0";
}
return sValue;
}
// 單選/多選下拉同理
function GetValueSel(el) {
var sValue = "";
for (var i = 0; i < el.options.length; i++) {
// 提示用的選項請將 value 設為空字串
if (el.options[i].selected && el.options[i].value != "") {
sValue += "0";
}
}
return sValue;
}
}
// 通用回焦:驗證未通過時的焦點處理
function GoBack(el) {
switch (el.type) {
case "text":
case "hidden":
case "password":
case "file":
case "textarea":
el.focus();
var rng = el.createTextRange ? el.createTextRange() : null;
if (rng) { rng.collapse(false); rng.select(); }
break;
case "checkbox":
case "radio":
document.getElementsByName(el.name)[0].focus();
break;
case "select-one":
case "select-multiple":
el.focus();
break;
}
}
這裡有兩處刻意修正了常見的抄寫版本:一是每個 case 尾端補上 break,否則會一路穿透執行到下一個分支;二是 createTextRange 加上存在性檢查,避免在非 IE 瀏覽器上丟出錯誤。
<script language="JavaScript" src="Check.js"></script>
<form name="form1" onsubmit="return CheckForm(this)">
test:<input type="text" name="test">不驗證<br>
帳號:<input type="text" name="id"
check="^\S+$" warning="帳號不能為空,且不能含有空格">不能為空<br>
密碼:<input type="password" name="pwd"
check="\S{6,}" warning="密碼六位以上">六位以上<br>
電話:<input type="text" name="number"
check="^\d+$" warning="電話號碼含有非法字元"><br>
相片上傳:<input type="file" name="pic"
check="(.*)(\.jpg|\.bmp)$" warning="相片應為 JPG、BMP 格式"><br>
出生日期:<input type="text" name="dt"
check="^\d{4}-\d{1,2}-\d{1,2}$" warning="日期格式 2004-08-10"><br>
省份:
<select name="sel" check="^0$" warning="請選擇所在省份">
<option value="">請選擇
<option value="1">福建省
<option value="2">湖北省
</select><br>
選擇你喜歡的運動:<br>
游泳<input type="checkbox" name="c" check="^0{2,}$" warning="請選擇 2 項或以上">
籃球<input type="checkbox" name="c">
足球<input type="checkbox" name="c"><br>
你的學歷:
大學<input type="radio" name="r" check="^0$" warning="請選擇一項學歷">
中學<input type="radio" name="r">
小學<input type="radio" name="r"><br>
個人介紹:
<textarea name="txts" check="^[\s\S]{20,}$"
warning="個人介紹不少於 20 字"></textarea><br>
<input type="submit">
</form>
核取方塊那組要注意:check 屬性只寫在第一個 checkbox 上即可,因為 GetValueChoose 會依 name 把整組一起撈出來算。
els[i].check 讀不到自訂屬性。跨瀏覽器時請改用 el.getAttribute('check')。^\d+$ 這種帶錨點的寫法比 \d+ 安全得多,後者會讓「abc123」也通過。required、pattern、type="email" 等原生屬性,能取代其中相當一部分的正規式;若要處理複雜規則,再搭配 jQuery Validation 這類成熟套件。