DIV CSS 佈局教程網

自製 jQuery 表單驗證類:正則規則集中管理
編輯:JavaScript綜合知識     

表單驗證若散落在各處,規則一改就要動幾十個地方。把規則集中到一個物件裡,用自訂屬性宣告式地套用到各欄位,是維護成本最低的做法。

用法:在 HTML 上宣告規則

<form action="" method="post" id="formValidate">
  數值:<input type="text" validate="number" /><span></span><br/>
  浮點型:<input type="text" validate="decimal" /><span></span><br/>
  英文:<input type="text" validate="english" /><span></span><br/>
  大寫英文:<input type="text" validate="upper_english" /><span></span><br/>
  小寫英文:<input type="text" validate="lower_english" /><span></span><br/>
  郵件格式:<input type="text" validate="email" /><span></span><br/>
  是否含中文:<input type="text" validate="chinese" /><span></span><br/>
  URL:<input type="text" validate="url" /><span></span><br/>
  電話號碼:<input type="text" validate="phone" /><span></span><br/>
  IP地址:<input type="text" validate="ip" /><span></span><br/>
  金額:<input type="text" validate="money" /><span></span><br/>
  數字或英文或_:<input type="text" validate="number_letter" /><span></span><br/>
  郵政編碼:<input type="text" validate="zip_code" /><span></span><br/>
  可用帳號:<input type="text" validate="account" /><span></span><br/>
  QQ:<input type="text" validate="qq" /><span></span><br/>
  身份證:<input type="text" validate="card" /><span></span><br/>

  數值(允許為空):<input type="text" validate="number" empty="yes" /><span></span><br/>
  數值(長度 1-3):<input type="text" validate="number" min="1" max="3" /><span></span><br/>
  數值(長度 1-3,可空):<input type="text" validate="number" min="1" max="3" empty="yes" /><span></span><br/>

  <input type="submit" />
</form>

<script src="jquery.js"></script>
<script src="formValidate.js"></script>
<script>
var formValidate = new formValidate();
formValidate.init({});
</script>

設計重點是三個自訂屬性:validate 指定規則名稱、empty 決定是否允許留空、min/max 限制長度。每個欄位後面那個空的 <span> 就是提示訊息的顯示位置——這個「欄位 + 提示容器」成對出現的約定,讓錯誤訊息能精準落在對應欄位旁邊,而不必用 alert 打斷使用者。

規則表:整個類的核心

var formValidate = function () {
  var _this = this;

  this.options = {
    number:        { reg: /^[0-9]+$/,   str: '必須為數字' },
    decimal:       { reg: /^[-]{0,1}(\d+)[\.]+(\d+)$/, str: '必須為 DECIMAL 格式' },
    english:       { reg: /^[A-Za-z]+$/, str: '必須為英文字母' },
    upper_english: { reg: /^[A-Z]+$/,   str: '必須為大寫英文字母' },
    lower_english: { reg: /^[a-z]+$/,   str: '必須為小寫英文字母' },
    email:         { reg: /^([a-zA-Z0-9]+[_.]?)*[a-zA-Z0-9]+@([a-zA-Z0-9]+[_.]?)*[a-zA-Z0-9]+\.[a-zA-Z]{2,3}$/,
                     str: 'Email 格式不正確' },
    chinese:       { reg: /[\u4E00-\u9FA5\uF900-\uFA2D]/ig, str: '必須含有中文' },
    url:           { reg: /^[a-zA-z]+:\/\/[^\s]*/, str: 'URL 格式不正確' },
    phone:         { reg: /^[1][3][0-9]{9}$/, str: '電話號碼格式不正確' },
    ip:            { reg: /^(\d+)\.(\d+)\.(\d+)\.(\d+)$/, str: 'IP 地址格式不正確' },
    money:         { reg: /^[0-9]+[.][0-9]{0,3}$/, str: '金額格式不正確' },
    number_letter: { reg: /^[0-9a-zA-Z_]+$/, str: '只允許輸入英文字母、數字、_' },
    zip_code:      { reg: /^[a-zA-Z0-9 ]{3,12}$/, str: '郵政編碼格式不正確' },
    account:       { reg: /^[a-zA-Z][a-zA-Z0-9_]{4,15}$/,
                     str: '帳號名不合法,允許 5-16 字元,字母下劃線和數字' },
    qq:            { reg: /[1-9][0-9]{4,}/, str: 'QQ 帳號不正確' },
    card:          { reg: /^(\d{6})(18|19|20)?(\d{2})([01]\d)([0123]\d)(\d{3})(\d|X)?$/,
                     str: '身份證號碼不正確' }
  };

  this.init = function (options) {
    this.setOptions(options);
    this.checkForm();
  };

  this.setOptions = function (options) {
    for (var key in options) {
      if (key in this.options) { this.options[key] = options[key]; }
    }
  };

  // 單一欄位的正則檢核
  this.check = function (value, type) {
    if (this.options[type]) {
      if (!this.options[type]['reg'].test(value)) {
        return this.options[type]['str'];
      }
      return true;
    }
    return '找不到該表單驗證規則項';
  };

  // 表單層級:空值 → 長度 → 正則
  this.checkForm = function () {
    $("#formValidate").submit(function () {
      var formChind = $("#formValidate").children();
      var testResult = true;

      formChind.each(function (i) {
        var child    = formChind.eq(i);
        var value    = child.val();
        var len      = value.length;
        var childSpan = child.next();

        // 1. 是否允許為空
        if (child.attr('empty')) {
          if (child.attr('empty') == 'yes' && value == '') {
            if (childSpan) childSpan.html('');
            return;   // 允許空,跳過後續檢查
          }
        }

        // 2. 長度上下限
        var min = child.attr('min'), max = child.attr('max');
        if (min && max) {
          if (len < min || len > max) {
            childSpan.html(' 字串長度在' + min + '與' + max + '之間');
            testResult = false; return;
          }
        } else if (min) {
          if (len < min) { childSpan.html(' 字串長度應大於' + min); testResult = false; return; }
        } else if (max) {
          if (len > max) { childSpan.html(' 字串長度應小於' + max); testResult = false; return; }
        }

        // 3. 正則檢核
        if (child.attr('validate')) {
          var result = _this.check(value, child.attr('validate'));
          if (childSpan) {
            childSpan.html('');
            if (result != true) { childSpan.html(' ' + result); testResult = false; }
          }
        }
      });

      return testResult;   // 回傳 false 即可阻止表單送出
    });
  };
};

這個設計好在後的三件事

規則與欄位分離:正則表是單一資料來源,要改 email 規則只動一處,所有用它的欄位同步生效。

檢查順序有講究:先查空值、再查長度、最後才跑正則。這個順序不能隨便調——空字串丟進 email 正則會產生誤判訊息,使用者看到「Email 格式不正確」但其實問題是「沒填」,體驗很差。

回傳 false 阻止送出:綁在 submit 事件上的處理器回傳 false 或呼叫 preventDefault(),表單就不會送出。這是整個機制的關鍵。

原範例要修的地方

原稿的正則裡 \d 被寫成了 d,反斜線在流傳中掉了。少了它,decimal 規則會變成「必須含有字母 d」,ip、card 等規則也全部失效。上面的程式碼已修正,請以修正版為準。

phone 規則寫死中國手機格式(1[3x]\d{9}),台灣的 09 開頭號碼完全不符。實際使用時務必替換成在地規則,例如台灣手機可用 /^09\d{2}-?\d{3}-?\d{3}$/,市話則是 /^0\d{1,2}-?\d{6,8}$/。

attr() 應改為 prop() 或直接用 HTML5 屬性。這套自訂屬性的做法,其實正是 HTML5 驗證 API 想取代的東西。今天可以直接用:

<input type="email" required minlength="1" maxlength="3" pattern="[0-9]+">

搭配 form.checkValidity() 與 :invalid 這兩個 CSS 虛擬類別,不必載入任何函式庫就能完成同樣的事,而且原生支援無障礙(螢幕閱讀器會自動朗讀驗證訊息)。

後端驗證不可省:前端驗證的目的是「即時回饋、減少無謂往返」,不是安全防線。使用者關掉 JavaScript 或用工具直接送請求就能完全繞過,伺服器端一定要用同一份規則再驗一次。

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