DIV CSS 佈局教程網

EasyUI validatebox 表單驗證實戰與自定義規則擴展
編輯:JavaScript基礎知識     

EasyUI 的 validatebox 把表單驗證抽象成「宣告式」:只要為輸入框標上 validtype,框架就會在失焦或提交時自動檢查,並顯示提示訊息。當內建規則無法覆蓋業務需求時,也可以通过擴充規則表快速補上。

一、頁面結構與基本用法

先載入 jQuery、EasyUI 與自定義規則檔,然後在 ready 階段對目標輸入框啟用 validatebox:

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
  <script src="easyui1.2.4/jquery-1.6.min.js" type="text/javascript"></script>
  <script src="easyui1.2.4/jquery.easyui.min.js" type="text/javascript"></script>
  <!-- 自定義驗證 -->
  <script src="easyui1.2.4/validator.js" type="text/javascript"></script>
  <link href="easyui1.2.4/themes/default/easyui.css" rel="stylesheet" type="text/css" />
  <script>
    $(function () {
      // 讓所有 text 類型輸入框具備驗證能力
      $('input[type=text]').validatebox();
    });
  </script>
</head>
<body>
  郵箱驗證:<input type="text" validtype="email" required="true"
             missingMessage="不能為空" invalidMessage="郵箱格式不正確" /><br />
  網址驗證:<input type="text" validtype="url"
             invalidMessage="url格式不正確[https://www.example.com]" /><br />
  長度驗證:<input type="text" validtype="length[8,20]"
             invalidMessage="有效長度8-20" /><br />
  手機驗證:<input type="text" validtype="mobile" /><br />
  郵編驗證:<input type="text" validtype="zipcode" /><br />
  賬號驗證:<input type="text" validtype="account[8,20]" /><br />
  漢字驗證:<input type="text" validtype="CHS" /><br />
  遠程驗證:<input type="text" validtype="remote['checkname.aspx','name']"
             invalidMessage="用戶名已存在" />
</body>
</html>

幾個常用屬性的分工值得記住:required 控制必填,missingMessage 是「未填寫」時的提示,invalidMessage 則是「格式不符」時的提示。方括號內的參數會作為第二個引數傳給驗證函數。

二、擴充自定義驗證規則

EasyUI 把內建規則掛在 $.fn.validatebox.defaults.rules 上,直接擴充這個物件即可註冊新規則。每條規則包含一個 validator 函數(回傳 boolean)與一個 message:

// validator.js —— 擴充 EasyUI 表單驗證規則
$.extend($.fn.validatebox.defaults.rules, {

  // 漢字驗證
  CHS: {
    validator: function (value) {
      return /^[\u0391-\uFFE5]+$/.test(value);
    },
    message: '只能輸入漢字'
  },

  // 行動手機號碼驗證
  mobile: {
    // value 為文本框中的值
    validator: function (value) {
      var reg = /^1[3|4|5|8|9]\d{9}$/;
      return reg.test(value);
    },
    message: '輸入手機號碼格式不准確.'
  },

  // 國內郵編驗證
  zipcode: {
    validator: function (value) {
      var reg = /^[1-9]\d{5}$/;
      return reg.test(value);
    },
    message: '郵編必須是非 0 開始的 6 位數字.'
  },

  // 用戶賬號驗證(只能包含 _ 、數字、字母)
  account: {
    // param 的值即為 [] 中的內容
    validator: function (value, param) {
      if (value.length < param[0] || value.length > param[1]) {
        $.fn.validatebox.defaults.rules.account.message =
          '用戶名長度必須在' + param[0] + '至' + param[1] + '範圍';
        return false;
      }
      if (!/^[\w]+$/.test(value)) {
        $.fn.validatebox.defaults.rules.account.message =
          '用戶名只能由數字、字母、下劃線組成.';
        return false;
      }
      return true;
    },
    message: ''
  }
});

要點說明:

  • 帶參數的規則:宣告 validtype="account[8,20]" 時,[8,20] 會以陣列形式作為 validator 的第二個引數傳入。
  • 動態提示:在 validator 內部改寫規則的 message,可以依實際失敗原因給出不同提示,比單一靜態訊息友善得多。
  • 遠程驗證:remote['checkname.aspx','name'] 會把欄位值送到後端檢查(例如帳號是否已註冊),適合唯一性這類無法在前端判斷的規則。

實作時建議把自定義規則集中放在獨立檔案中,與頁面結構分離;同時留意正則的邊界條件(例如手機號第二段用 [3|4|5|8|9] 時,| 在字元 group 內其實是字面量,嚴格來說應寫成 [345789]),避免規則看似生效卻在特定號段上失效。

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