萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery EasyUI 表單驗證與提交完整實戰:validatebox、required、validType、AJAX 提交

EasyUI 是基於 jQuery 的經典 UI 庫,其表單驗證功能(validatebox)聲明式、易用、支援內置/自定義驗證規則。本文展示完整表單結構、驗證規則配置、AJAX 提交流程與常見問題處理。

HTML 表單結構

<form id="myForm" method="post">
  <table align="center" style="width:400px;margin-top:20px;">
    <tr>
      <td align="right">命令:</td>
      <td>
        <input id="cmd" name="cmd" style="width:200px;" 
               class="easyui-validatebox" 
               required="true" 
               validType="length[5,12]" 
               missingMessage="不能為空" />
      </td>
    </tr>
    <tr>
      <td align="right">描述:</td>
      <td>
        <input id="depict" name="depict" style="width:200px;" 
               class="easyui-validatebox" 
               required="true" 
               validType="length[5,12]" 
               missingMessage="不能為空" />
      </td>
    </tr>
    <tr>
      <td align="right">類型:</td>
      <td>
        <input id="type" style="width:200px" 
               class="easyui-combobox" 
               url="data/editHealthCheckCombobox_data.json" 
               valueField="id" textField="text" />
      </td>
    </tr>
    <tr>
      <td align="right">分數:</td>
      <td>
        <input id="score" name="score" style="width:200px" class="easyui-numberspinner" />
      </td>
    </tr>
    <tr>
      <td align="right">使用狀況:</td>
      <td>
        <input id="isUse" style="width:200px" class="easyui-validatebox" />
      </td>
    </tr>
    <tr>
      <td align="center" colspan="2">
        <input type="submit" value="提交" />
        <input type="reset" value="重置" />
      </td>
    </tr>
  </table>
</form>

核心驗證屬性解析

屬性作用示例
class="easyui-validatebox"啟用驗證框組件必須
required="true"必填項空值時顯示 missingMessage
missingMessage為空時的提示文本"不能為空"
validType驗證類型"email"、"length[5,12]"、"remote['url', 'param']"
invalidMessage格式錯誤時提示"格式不正確"

內置驗證類型 (validType)

// 常用內置類型
'email'           // 郵箱格式
'url'             // URL 格式
'length[0,100]'   // 長度範圍
'remote[url,param]' // 遠程驗證(AJAX)
'equals[#fieldId]'  // 與某字段值相等(如確認密碼)

AJAX 提交核心代碼

$('#myForm').form({
  url: '/ProcessServlet', // 提交地址
  onSubmit: function() {
    // 1. 觸發驗證,返回 false 阻止提交
    return $(this).form('validate');
  },
  success: function(data) {
    // 2. 服務端返回處理
    // data 為字串,若返回 JSON 需手動解析
    try {
      var result = JSON.parse(data);
      if (result.success) {
        $.messager.alert('成功', '保存成功!', 'info');
      } else {
        $.messager.alert('失敗', result.msg || '保存失敗', 'error');
      }
    } catch (e) {
      alert(data); // 非 JSON 直接彈窗
    }
  },
  onLoadError: function() {
    $.messager.alert('錯誤', '請求失敗,請檢查網絡', 'error');
  }
});

關鍵 API 詳解

// 1. 手動觸發驗證
$('#myForm').form('validate'); // 返回 true/false

// 2. 獲取表單數據 (JSON 對象)
var data = $('#myForm').form('serialize'); // 序列化為字串
var dataObj = $('#myForm').form('serializeArray'); // 數組對象

// 3. 填充表單
$('#myForm').form('load', { cmd: 'test', depict: '描述' });
// 或從 URL 加載
$('#myForm').form('load', 'api/getData?id=1');

// 4. 重置表單
$('#myForm').form('clear'); // 清空值
$('#myForm').form('reset'); // 重置為初始值

// 5. 動態添加/移除驗證規則
$('#cmd').validatebox({
  required: true,
  validType: 'length[3,20]'
});
$('#cmd').validatebox('remove'); // 移除驗證

自定義驗證規則擴展

$.extend($.fn.validatebox.defaults.rules, {
  // 手機號驗證
  mobile: {
    validator: function(value) {
      return /^1[3-9]\d{9}$/.test(value);
    },
    message: '手機號格式不正確'
  },
  // 中文姓名
  chineseName: {
    validator: function(value) {
      return /^[\u4e00-\u9fa5]{2,10}$/.test(value);
    },
    message: '請輸入 2-10 位中文姓名'
  },
  // 遠程驗證(如用戶名唯一性)
  unique: {
    validator: function(value, param) {
      var result = false;
      $.ajax({
        url: param[0],
        data: { value: value },
        async: false, // 同步驗證
        success: function(data) {
          result = data.valid === true;
        }
      });
      return result;
    },
    message: '該值已存在'
  }
});

// 使用
<input class="easyui-validatebox" validType="mobile" />
<input class="easyui-validatebox" validType="unique['/api/check']" />

常見問題與解決

問題原因解決
驗證不生效未引入 easyui.css / 類名拼寫錯誤檢查引用、類名為 easyui-validatebox
提交前不驗證未在 onSubmit 返回 validate()onSubmit: function(){ return $(this).form('validate'); }
Combobox 不驗證Combobox 隱藏原 input驗證隱藏的 input,或用 required 配合 panel 事件
reset 不清除驗證提示EasyUI 不自動清除手動調用 .validatebox('reset')

現代替代方案

  • Vue/React + VeeValidate / Formik / React Hook Form:聲明式、TypeScript 支援、生態豐富
  • 原生 HTML5 驗證:required、pattern、minlength、:valid/:invalid 偽類
  • 輕量庫:validator.js、zod(Schema 驗證)
copyright © 萬盛學電腦網 all rights reserved