@yibozhang/pro-table 0.0.4 → 0.0.5

package/bundles/yibozhang-pro-table.umd.js

@@ -2742,60 +2742,90 @@
         { type: i1.FormBuilder }
     ]; };
 
-    /**
-     * 数组型数据收集基础服务
-     *
-     * 功能：
-     * 1. 支持通过 ngModel 绑定对应行的数据源
-     * 2. 自动为数组数据添加 isEdit 和 uid 字段
-     * 3. 支持每个字段的自定义校验方法，返回 'success' | 'warning' | 'error'
-     * 4. 提供公共方法支持删除、新增、编辑等操作
-     */
+    /** 数组型数据收集基础服务 */
     var ArrayFormService = /** @class */ (function () {
         function ArrayFormService() {
             this.formStore = {};
         }
-        /**
-         * 初始化数组数据
-         * 为现有数据添加 uid 和 isEdit 字段
-         *
-         * @param data 原始数据数组
-         * @param config 表单配置
-         * @returns 初始化后的数据数组
-         */
+        /** 深度克隆值 */
+        ArrayFormService.prototype.cloneValue = function (value) {
+            var e_1, _c;
+            var _this = this;
+            if (value === null || value === undefined) {
+                return value;
+            }
+            if (Array.isArray(value)) {
+                return value.map(function (item) { return _this.cloneValue(item); });
+            }
+            if (typeof value === "object") {
+                var cloned = {};
+                try {
+                    for (var _d = __values(Object.keys(value)), _e = _d.next(); !_e.done; _e = _d.next()) {
+                        var key = _e.value;
+                        cloned[key] = this.cloneValue(value[key]);
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (_e && !_e.done && (_c = _d.return)) _c.call(_d);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+                return cloned;
+            }
+            return value;
+        };
+        /** 比较两个值是否相等 */
+        ArrayFormService.prototype.isEqual = function (a, b) {
+            var _this = this;
+            if (a === b)
+                return true;
+            if (a === null || b === null)
+                return a === b;
+            if (a === undefined || b === undefined)
+                return a === b;
+            if (typeof a !== typeof b)
+                return false;
+            if (Array.isArray(a) && Array.isArray(b)) {
+                if (a.length !== b.length)
+                    return false;
+                return a.every(function (item, index) { return _this.isEqual(item, b[index]); });
+            }
+            if (typeof a === "object" && typeof b === "object") {
+                var keysA = Object.keys(a);
+                var keysB = Object.keys(b);
+                if (keysA.length !== keysB.length)
+                    return false;
+                return keysA.every(function (key) { return _this.isEqual(a[key], b[key]); });
+            }
+            return false;
+        };
+        /** 创建行的初始值快照 */
+        ArrayFormService.prototype.createRowSnapshot = function (row, fields) {
+            var _this = this;
+            var snapshot = {};
+            fields.forEach(function (field) {
+                snapshot[field.name] = _this.cloneValue(row[field.name]);
+            });
+            return snapshot;
+        };
+        /** 初始化数组数据，添加 uid 和 isEdit 字段 */
         ArrayFormService.prototype.initializeData = function (data) {
             var _this = this;
             return data.map(function (item) { return _this.enrichRow(item); });
         };
-        /**
-         * 为单行数据添加 uid 和 isEdit 字段
-         *
-         * @param row 原始行数据
-         * @returns 增强后的行数据
-         */
+        /** 为单行数据添加 uid 和 isEdit 字段 */
         ArrayFormService.prototype.enrichRow = function (row) {
-            return Object.assign(Object.assign({}, row), { uid: row.uid || uuid.v4(), isEdit: row.isEdit !== undefined ? row.isEdit : false });
+            return Object.assign(Object.assign({}, row), { uid: row.uid || uuid.v4(), isEdit: row.isEdit !== undefined ? row.isEdit : false, disabled: row.disabled !== undefined ? row.disabled : false });
         };
-        /**
-         * 新增一行数据
-         *
-         * @param data 数据数组引用
-         * @param defaultValues 默认值
-         * @returns 新增的行数据
-         */
+        /** 新增一行数据 */
         ArrayFormService.prototype.addRow = function (data, defaultValues) {
-            var newRow = Object.assign(Object.assign({}, defaultValues), { uid: uuid.v4(), isEdit: true, isAdd: true });
+            var newRow = Object.assign(Object.assign({}, defaultValues), { uid: uuid.v4(), isEdit: true, isAdd: true, disabled: false });
             data.push(newRow);
             return newRow;
         };
-        /**
-         * 校验单个字段
-         *
-         * @param row 行数据
-         * @param fieldName 字段名
-         * @param config 表单配置
-         * @returns 校验结果
-         */
+        /** 校验单个字段 */
         ArrayFormService.prototype.validateField = function (row, fieldName, config) {
             var fieldConfig = config.fields.find(function (f) { return f.name === fieldName; });
             if (!fieldConfig) {
@@ -2806,13 +2836,7 @@
             }
             return "";
         };
-        /**
-         * 校验整行数据
-         *
-         * @param row 行数据
-         * @param config 表单配置
-         * @returns 校验结果对象，key为字段名，value为校验结果
-         */
+        /** 校验整行数据 */
         ArrayFormService.prototype.validateRow = function (row, config) {
             var _this = this;
             var results = {};
@@ -2821,13 +2845,7 @@
             });
             return results;
         };
-        /**
-         * 校验整个数组
-         *
-         * @param data 数据数组
-         * @param config 表单配置
-         * @returns 校验结果对象，key为行的uid，value为该行的校验结果
-         */
+        /** 校验整个数组 */
         ArrayFormService.prototype.validateData = function (data, config) {
             var _this = this;
             var results = {};
@@ -2836,90 +2854,149 @@
             });
             return results;
         };
-        /**
-         * 注册表单到存储
-         * 如果表单已存在，则更新其配置
-         *
-         * @param formName 表单名称
-         * @param data 数据数组
-         * @param config 表单配置
-         */
+        /** 注册表单到存储 */
         ArrayFormService.prototype.registerForm = function (formName, data, config) {
+            var _this = this;
+            var initializedData = this.initializeData(data);
+            // 记录初始值快照
+            var initialSnapshot = {};
+            initializedData.forEach(function (row) {
+                initialSnapshot[row.uid] = _this.createRowSnapshot(row, config.fields);
+            });
             this.formStore[formName] = {
-                data: this.initializeData(data),
+                data: initializedData,
                 config: config,
                 validationResults: {},
+                initialSnapshot: initialSnapshot,
+                editingSnapshot: {},
+                allTouched: false,
+                rowTouched: {},
             };
             // 如果配置了自动更新，立即更新一次
             this.autoUpdateArrayReference(formName);
         };
-        /**
-         * 从存储中获取表单
-         *
-         * @param formName 表单名称
-         * @returns 表单存储项或undefined
-         */
+        /** 从存储中获取表单 */
         ArrayFormService.prototype.getForm = function (formName) {
             return this.formStore[formName];
         };
-        /**
-         * 向表单添加行
-         *
-         * @param formName 表单名称
-         * @param defaultValues 默认值
-         * @returns 新增的行数据或undefined
-         */
+        /** 从存储中获取表单数据 */
+        ArrayFormService.prototype.getFormData = function (formName) {
+            var form = this.formStore[formName];
+            if (!form) {
+                return undefined;
+            }
+            return form.data.map(function (item) {
+                delete item.isEdit;
+                delete item.isAdd;
+                delete item.uid;
+                return item;
+            });
+        };
+        /** 向表单添加行 */
         ArrayFormService.prototype.addRowToForm = function (formName, defaultValues) {
             var form = this.formStore[formName];
             if (!form) {
                 return undefined;
             }
             var newRow = this.addRow(form.data, defaultValues);
+            // 为新行记录初始值快照
+            form.initialSnapshot[newRow.uid] = this.createRowSnapshot(newRow, form.config.fields);
             // 自动更新外部数组引用
             this.autoUpdateArrayReference(formName);
             return newRow;
         };
-        /**
-         * 校验表单
-         *
-         * @param formName 表单名称
-         * @returns 校验结果或undefined
-         */
+        /** 校验表单，自动标记所有字段为已触碰 */
         ArrayFormService.prototype.validateForm = function (formName) {
+            var e_2, _c, e_3, _d;
             var form = this.formStore[formName];
             if (!form) {
-                return undefined;
+                return true;
             }
+            // 标记所有字段为已触碰
+            form.allTouched = true;
             var results = this.validateData(form.data, form.config);
             form.validationResults = results;
-            return results;
+            try {
+                // 检查是否有任何错误
+                for (var _e = __values(Object.keys(results)), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    var uid = _f.value;
+                    try {
+                        for (var _g = (e_3 = void 0, __values(Object.keys(results[uid]))), _h = _g.next(); !_h.done; _h = _g.next()) {
+                            var fieldName = _h.value;
+                            if (results[uid][fieldName]) {
+                                return false;
+                            }
+                        }
+                    }
+                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    finally {
+                        try {
+                            if (_h && !_h.done && (_d = _g.return)) _d.call(_g);
+                        }
+                        finally { if (e_3) throw e_3.error; }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_f && !_f.done && (_c = _e.return)) _c.call(_e);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            return true;
         };
-        /**
-         * 开启指定行的编辑模式
-         *
-         * @param row 行数据
-         */
-        ArrayFormService.prototype.enableEdit = function (row) {
+        /** 开启编辑模式，保存快照用于取消恢复 */
+        ArrayFormService.prototype.enableEdit = function (formName, row) {
+            var form = this.formStore[formName];
+            if (form && row.uid) {
+                // 保存编辑前的快照
+                form.editingSnapshot[row.uid] = this.createRowSnapshot(row, form.config.fields);
+            }
             row.isEdit = true;
         };
-        /**
-         * 关闭指定行的编辑模式
-         *
-         * @param row 行数据
-         */
-        ArrayFormService.prototype.disableEdit = function (row) {
+        /** 取消编辑，恢复到编辑前的数据 */
+        ArrayFormService.prototype.disableEdit = function (formName, row) {
+            var _this = this;
+            var form = this.formStore[formName];
+            if (form && row.uid && form.editingSnapshot[row.uid]) {
+                // 恢复编辑前的数据
+                var snapshot_1 = form.editingSnapshot[row.uid];
+                form.config.fields.forEach(function (field) {
+                    row[field.name] = _this.cloneValue(snapshot_1[field.name]);
+                });
+                // 更新初始快照为恢复后的值，消除 touched 状态
+                form.initialSnapshot[row.uid] = this.cloneValue(snapshot_1);
+                // 清理编辑快照和 touched 状态
+                delete form.editingSnapshot[row.uid];
+                delete form.rowTouched[row.uid];
+                // 清理该行的校验结果
+                if (form.validationResults) {
+                    delete form.validationResults[row.uid];
+                }
+            }
             row.isEdit = false;
         };
-        /**
-         * 从表单中删除指定行
-         *
-         * @param formName 表单名称
-         * @param row 行的uid
-         * @returns 是否删除成功
-         */
+        /** 确认编辑，保留修改后的数据 */
+        ArrayFormService.prototype.confirmEdit = function (formName, row) {
+            var form = this.formStore[formName];
+            if (form && row.uid) {
+                // 清理编辑快照（保留当前数据）
+                if (form.editingSnapshot[row.uid]) {
+                    delete form.editingSnapshot[row.uid];
+                }
+                // 更新初始快照为当前值（用于后续 touched 检测）
+                form.initialSnapshot[row.uid] = this.createRowSnapshot(row, form.config.fields);
+                // 清除 touched 状态，基于新的 initialSnapshot 重新判断
+                delete form.rowTouched[row.uid];
+            }
+            row.isEdit = false;
+            row.isAdd = false;
+        };
+        /** 从表单中删除指定行 */
         ArrayFormService.prototype.deleteRowFromForm = function (formName, row) {
             var form = this.formStore[formName];
-            if (!form) {
+            if (!form || !row.uid) {
                 return false;
             }
             var index = form.data.findIndex(function (item) { return item.uid === row.uid; });
@@ -2927,31 +3004,44 @@
                 return false;
             }
             form.data.splice(index, 1);
-            if (form.validationResults && form.validationResults[row.uid]) {
+            // 清理该行的所有快照、touched 状态和校验结果
+            delete form.initialSnapshot[row.uid];
+            delete form.editingSnapshot[row.uid];
+            delete form.rowTouched[row.uid];
+            if (form.validationResults) {
                 delete form.validationResults[row.uid];
             }
             // 自动更新外部数组引用
             this.autoUpdateArrayReference(formName);
             return true;
         };
-        /**
-         * 校验指定行的指定字段并返回校验结果
-         * 实时执行校验，用于模板中的实时校验显示
-         *
-         * @param formName 表单名称
-         * @param row 行数据
-         * @param fieldName 字段名
-         * @returns 校验结果
-         */
+        /** 检测字段是否已被触碰 */
+        ArrayFormService.prototype.isFieldTouched = function (form, row, fieldName) {
+            var _a;
+            // 整个表单已 touched（整个表单提交时）
+            if (form.allTouched) {
+                return true;
+            }
+            // 当前行已 touched（单行保存时）
+            if (form.rowTouched[row.uid]) {
+                return true;
+            }
+            // 检测当前值与初始值是否不同
+            var initialValue = (_a = form.initialSnapshot[row.uid]) === null || _a === void 0 ? void 0 : _a[fieldName];
+            var currentValue = row[fieldName];
+            return !this.isEqual(initialValue, currentValue);
+        };
+        /** 校验指定行的指定字段，未修改时不显示校验状态 */
         ArrayFormService.prototype.validateFieldInRow = function (formName, row, fieldName) {
             var form = this.formStore[formName];
             if (!form) {
-                return "success";
+                return "";
             }
             var fieldConfig = form.config.fields.find(function (f) { return f.name === fieldName; });
             if (!fieldConfig) {
-                return "success";
+                return "";
             }
+            // 执行校验
             var result = "";
             if (fieldConfig.validator) {
                 result = fieldConfig.validator(row[fieldName], row, fieldName);
@@ -2964,21 +3054,36 @@
                 form.validationResults[row.uid] = {};
             }
             form.validationResults[row.uid][fieldName] = result;
+            // 如果字段未被触碰，不显示校验状态
+            if (!this.isFieldTouched(form, row, fieldName)) {
+                return "";
+            }
             return result ? "error" : "success";
         };
-        /**
-         * 校验指定行的所有字段
-         *
-         * @param formName 表单名称
-         * @param row 行数据
-         * @returns 是否所有字段都通过校验
-         */
+        /** 获取指定行指定字段的校验错误信息 */
+        ArrayFormService.prototype.getFieldErrorMessage = function (formName, row, fieldName) {
+            var _a, _b;
+            var form = this.formStore[formName];
+            if (!form || !row.uid) {
+                return "";
+            }
+            // 如果字段未被触碰，不显示错误信息
+            if (!this.isFieldTouched(form, row, fieldName)) {
+                return "";
+            }
+            return ((_b = (_a = form.validationResults) === null || _a === void 0 ? void 0 : _a[row.uid]) === null || _b === void 0 ? void 0 : _b[fieldName]) || "";
+        };
+        /** 校验指定行的所有字段 */
         ArrayFormService.prototype.validateRowAllFields = function (formName, row) {
             var _this = this;
             var form = this.formStore[formName];
-            if (!form) {
+            if (!form || !row.uid) {
                 return true;
             }
+            // 更新初始快照为当前值
+            form.initialSnapshot[row.uid] = this.createRowSnapshot(row, form.config.fields);
+            // 标记当前行为 touched（只影响当前行，不影响其他行）
+            form.rowTouched[row.uid] = true;
             var hasError = false;
             form.config.fields.forEach(function (fieldConfig) {
                 var result = _this.validateFieldInRow(formName, row, fieldConfig.name);
@@ -2988,12 +3093,7 @@
             });
             return !hasError;
         };
-        /**
-         * 自动更新外部数组引用（如果配置了）
-         * 私有方法，在数据变化时自动调用
-         *
-         * @param formName 表单名称
-         */
+        /** 自动更新外部数组引用 */
         ArrayFormService.prototype.autoUpdateArrayReference = function (formName) {
             var form = this.formStore[formName];
             if (!form || !form.config.targetObject || !form.config.arrayPropertyName) {
@@ -3003,6 +3103,14 @@
             // 更新目标对象的数组属性为新数组引用
             form.config.targetObject[form.config.arrayPropertyName] = newArray;
         };
+        /** 是否有正在编辑的行 */
+        ArrayFormService.prototype.hasEditingRow = function (formName) {
+            var form = this.formStore[formName];
+            if (!form) {
+                return false;
+            }
+            return form.data.some(function (item) { return item.isEdit; });
+        };
         return ArrayFormService;
     }());
     ArrayFormService.ɵprov = i0.ɵɵdefineInjectable({ factory: function ArrayFormService_Factory() { return new ArrayFormService(); }, token: ArrayFormService, providedIn: "root" });