做專案時我陸續寫了一些驗證用的零散方法,思路是「傳欄位 id 進去,需要驗格式的話再傳一條正則」。專案結束後回頭看,這種寫法其實沒省下多少程式碼,而且同事反映不好用——雖然有說明文件,大家還是不太理解,於是寧願回頭用逐欄驗證的老方法:一個 JS 檔光驗證就兩三百行,註解能省則省,出問題時維護非常痛苦。
出差期間我一直在想:能不能包得更多、呼叫更簡單,最好連 JS 都不用寫?想到 jQuery 強大的選擇器,加上以往為了取值常在元素上掛自訂屬性,答案就出來了——驗證規則直接寫在 HTML 的自訂屬性上,這應該是最直觀的做法。
先引入相依檔案:
<script src="Js/jquery-1.4.2.min.js" type="text/javascript"></script> <script src="Js/ks.ext.msgbox.js" type="text/javascript"></script> <script src="Js/validata.js" type="text/javascript"></script>
表單本體:
<form name="form1" id="form1" action="#" method="post">
郵 箱:<input type="text" id="email" name="email"
validata="email" errormsg="郵箱格式不正確"
emptyerrormsg="郵箱不能為空" empty="false" /><br />
手 機:<input type="text" name="phone" validata="phone"
errormsg="手機格式不正確" emptyerrormsg="手機不能為空" empty="true" /><br />
電 話:<input type="text" name="tel" validata="tel"
errormsg="電話格式不正確" emptyerrormsg="電話不能為空" empty="true" /><br />
身分證:<input type="text" name="idcard" validata="idcard"
errormsg="身份證格式不正確" emptyerrormsg="身份證不能為空" empty="false" /><br />
密 碼:<input type="password" name="pwd" validata="empty"
empty="false" emptyerrormsg="密碼不能為空" /><br />
確認密碼:<input type="password" name="pwd1" validata="password2"
errormsg="確認密碼不能為空" diffmsg="兩次密碼輸入不一致" /><br />
<input type="submit" id="submit1" value="Submit" />
</form>
validata 驗證型別,決定套用哪一條正則。
empty 是否允許留空。true 表示可為空,此時不驗格式;false 或省略則視為必填。
emptyerrormsg 留空時的提示文字;若省略或為空,顯示紅色 *。
errormsg 格式錯誤時的提示;規則同上。
diffmsg 兩次輸入不一致時的提示(供 password2 使用)。
以郵箱為例:有時候我們允許它為空,但一旦填了就得合法。empty="true" 就是這個意思;設為 false 或省略,則視為必填,這時 emptyerrormsg 才有意義。格式驗證則看 validata 的值,不合法時顯示 errormsg。
validata 的值不能任意自訂,需對應 JS 中已定義的型別。核心就是一個依名稱回傳正則的函式:
// 依不同的驗證內容回傳對應的正則
function returnRegString(regName) {
if (regName == "email") return "^([a-zA-Z0-9_\.\-])+\@(([a-zA-Z0-9\-])+\.)+([a-zA-Z0-9]{2,4})+$";
else if (regName == "tel") return "^(86)?(-)?(0[0-9]{2,3})?(-)?([0-9]{7,8})(-)?([0-9]{3,5})?$";
else if (regName == "phone") return "^(13[0-9]|15[0-9]|18[0-9])([0-9]{8})$";
else if (regName == "postcode") return "^([0-9]{6})$";
else if (regName == "number") return "^(0|([1-9]+[0-9]*))(.[0-9]+)?$";
else if (regName == "decimal") return "^[0-9]+([.][0-9]+)?$";
else if (regName == "money") return "^([0-9])$";
else if (regName == "website") return "(https://|https://){0,1}[\w\/\.\?\&\=]+";
else if (regName == "fax") return "^[+]{0,1}([0-9]){1,3}[ ]?([-]?(([0-9])|[ ]){1,12})+$";
else if (regName == "int") return "^(-){0,1}\d+$";
else if (regName == "pInt") return "^\d+$";
else if (regName == "nInt") return "^-\d+$";
else if (regName == "nandl") return "[a-zA-Z0-9]";
else if (regName == "chinese") return "[\u4e00-\u9fa5]";
}
要擴充新的型別,在這裡加一條 else if 即可。
它能涵蓋大約九成的基本驗證,包含失去焦點時的即時驗證與點擊提交時的整體驗證(未通過則以彈出層提示哪個欄位有問題,彈出層用的是我自己寫的仿人人網效果)。後端驗證則無能為力,只能各自處理。
這個庫還沒經過完整測試,若有先進願意試用,發現問題或有更好的改進方式,懇請不吝告知。市面上成熟的前端驗證庫當然不少,但自己動手做一遍,對「表單驗證到底該注意什麼」會有完全不同的理解。
改用 data-* 屬性。HTML5 已提供 data-validata、data-errormsg 這樣的標準寫法。自訂屬性在舊版 HTML 中並不合法(瀏覽器雖然會放過,但 validator 會報錯),而 data-* 是官方認可的。用 $el.data('validata') 讀取即可。
正則改成查表而非 else-if。一串 else if 每加一條規則就得動一次程式碼,且無法由外部擴充。改用物件對照表,就能讓呼叫方自行註冊:
var RULES = {
email: /^...$/,
phone: /^...$/,
chinese: /^[\u4e00-\u9fa5]+$/
};
// 允許外部擴充,不必改原始碼
$.extend(RULES, {
studentId: /^\d{8}$/
});
正則要加錨點並測試邊界。範例中的 money 寫成 ^([0-9])$ 只能驗證單一位數;nandl 與 chinese 少了 + 與首尾錨點,實際上只檢查「有沒有包含」而非「是否全部符合」。這類錯誤在逐欄驗證時容易被發現,寫成通用庫反而會被大量複用,影響範圍更大——通用元件裡的 bug 成本遠高於業務程式碼。
手機號碼規則該外置。號段會隨時間變動(4G/5G 新增号段),寫死在正則裡遲早過時。建議放在設定檔或由後端提供。
錯誤訊息應該可定位。彈出層只說「有欄位沒填」幫助有限。實務上更有效的做法是:把焦點移到第一個錯誤欄位、在欄位旁直接顯示訊息、並用 aria-invalid="true" 與 aria-describedby 讓螢幕閱讀器能關聯訊息與欄位。
前端驗證只是體驗,不是防線。這一點怎麼強調都不過分。任何繞過 JavaScript 的方式(停用 JS、直接打 API、改寫請求)都能跳過你的驗證庫。所有規則必須在後端重複實作一次,前端驗證的唯一目的,是讓使用者在填錯的第一時間就知道了,而不是等到送出後被退回。