萬盛學電腦網

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

EasyUI Form 表單提交完整最佳實踐:驗證、子表同步、進度條、異常處理

完整提交流程

$('#form').form({
    url: 'test/add.do',
    onSubmit: function() {
        // 1. 顯示進度條
        parent.$.messager.progress({ title: '提示', text: '數據處理中,請稍後....' });
        
        // 2. 子表結束編輯並驗證
        var gridValid = endEdit(); // 自定義:結束 Datagrid 編輯狀態
        if (!gridValid) {
            parent.$.messager.progress('close');
            return false;
        }
        
        // 3. 主表單驗證
        var isValid = $(this).form('validate');
        if (!isValid) {
            parent.$.messager.progress('close');
            return false;
        }
        
        // 4. 同步子表變更數據到隱藏域(新增/修改/刪除)
        accept(); // 自定義:收集子表數據寫入隱藏 input
        
        return true; // 允許提交
    },
    success: function(result) {
        // 5. 關閉進度條
        parent.$.messager.progress('close');
        
        try {
            // 6. 解析 JSON 回應
            var data = eval("(" + result + ")"); // 或 JSON.parse(result)
            
            if (data && data.success) {
                // 7. 成功處理
                parent.$.messager.alert('提示', data.msg || '添加成功');
                // 刷新父頁面 Grid
                parent.$.modalDialog.openner_grid.datagrid('reload');
                // 關閉當前對話框
                parent.$.modalDialog.handler.dialog('close');
            } else {
                // 8. 業務失敗
                parent.$.messager.alert('錯誤', data.msg);
            }
        } catch (e) {
            // 9. 解析異常/服務器 500
            parent.$.errorDialog(result); // 自定義錯誤彈窗
        }
    }
});

關鍵輔助函數

endEdit():結束子表編輯

var editIndex = undefined;
function endEdit(index) {
    if (index === undefined) return true;
    var dg = $('#childGrid');
    if (dg.datagrid('validateRow', index)) {
        dg.datagrid('endEdit', index);
        editIndex = undefined;
        return true;
    }
    return false;
}

accept():收集子表異動

function accept() {
    var dg = $('#childGrid');
    var inserted = dg.datagrid('getChanges', 'inserted');
    var updated = dg.datagrid('getChanges', 'updated');
    var deleted = dg.datagrid('getChanges', 'deleted');
    
    var changes = { inserted: inserted, updated: updated, deleted: deleted };
    $('#childChanges').val(JSON.stringify(changes)); // 隱藏域
}

最佳實踐總結表

階段關鍵動作注意事項
提交前進度條、子表 endEdit、主表 validate、同步子表數據任何驗證失敗必須 progress('close') 並 return false
成功回調解析 JSON、判斷 success、提示、刷新父 Grid、關閉對話框eval("("+result+")") 防御非標準 JSON;建議改 JSON.parse
異常處理捕獲 parse 錯誤、網路錯誤、HTTP 5xx統一 errorDialog 顯示原始回應便於除錯

現代化改良

  • 使用 fetch + FormData 替代 $.form,配合 async/await 簡化流程控制。
  • 後端統一回傳 {success: boolean, data: T, message: string} 規範,前端直接 response.json()。
  • 驗證邏輯前置:form.checkValidity() (HTML5) 或 vee-validate/zod。
  • 子表狀態管理:Redux/Vuex/Pinia 集中管理,避免 getChanges 手動同步。

結語

EasyUI form('submit') 搭配 onSubmit 驗證攔截、success 統一回調,構成了經典的「提交-驗證-同步-回調」閉環。掌握此模式能快速構建穩健的 CRUD 頁面,避免重複提交、驗證繞過、狀態不同步等常見坑點。

copyright © 萬盛學電腦網 all rights reserved