DIV CSS 佈局教程網

用 jQuery 做標籤智能驗證:屬性驅動的表單檢查元件 AutoValidate
編輯:JQuery特效代碼     

傳統表單驗證的做法是為每個欄位寫一段 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;
  });
});

四、HTML 端只要掛屬性

<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-* 屬性。
  • 只在失焦與點擊按鈕時驗證,使用者若從未離開某欄位就直接按 Enter 送出,仍可能繞過。建議同時攔截 form 的 submit 事件。
  • id 重複的問題:同組 checkbox 用 children(":checked") 判斷是對的,但整個元件在 $("#form1 [vld]") 的範圍下運作,多個表單並存時要留意 root 選擇器。
  • 身份證與電話的正則僅能檢查「格式」,無法驗證檢查碼或號段是否真實存在。涉及身分驗證時,仍應在後端做二次確認,前端驗證只用於改善使用者體驗。
  • 規則表裡的電話、身份證正則寫法較舊,若要沿用建議先補上測試案例,確認邊界值行為符合預期。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved