DIV CSS 佈局教程網

打造輕量前端驗證庫:用自訂屬性宣告規則,告別兩百行 if-else
編輯:JQuery特效代碼     

做專案時我陸續寫了一些驗證用的零散方法,思路是「傳欄位 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、改寫請求)都能跳過你的驗證庫。所有規則必須在後端重複實作一次,前端驗證的唯一目的,是讓使用者在填錯的第一時間就知道了,而不是等到送出後被退回。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved