cloud-web-corejs 1.1.0-dev.22 → 1.1.0-dev.24

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -29,7 +29,11 @@ import {
 } from "../../../../components/xform/utils/tableColumnHelper";
 import { mergeQueryParam } from "../../../../components/xform/utils/queryParamUtil";
 import { isFixedQueryWidget } from "../../../../components/xform/utils/fixedQueryUtil";
-import { isUrlValueColumn } from "../../../../components/xform/utils/attachmentValueUtil";
+import {
+  isUrlValueColumn,
+  normalizeAttachmentValue,
+  toModelValue,
+} from "../../../../components/xform/utils/attachmentValueUtil";
 import {
   EXPORT_TYPE,
   isItemExport,
@@ -204,6 +208,8 @@ modules = {
       treeKnownFormalKeyRegistry: new Set(),
       treeSingleSavePending: false,
       treeSingleSaveReconcileTask: null,
+      editAutoSaveTimers: {},
+      editAutoSaveQueue: null,
       // 列/网格未就绪时 setValue 只缓存数据，置此标志延后行 schema 构建
       pendingSchemaInit: false,
     };
@@ -234,6 +240,13 @@ modules = {
     customClass: function () {
       return this.widget.options.customClass || "";
     },
+    dataTableStyle: function () {
+      let width = this.widget.options.tableWidth;
+      if (width === null || width === undefined || width === "") return {};
+      width = String(width).trim();
+      if (/^\d+(?:\.\d+)?$/.test(width)) width += "px";
+      return { width };
+    },
     singleRowSelectFlag: function () {
       return !this.widget.options.showCheckBox;
     },
@@ -284,6 +297,10 @@ modules = {
     });
   },
   beforeDestroy: function () {
+    Object.values(this.editAutoSaveTimers || {}).forEach((timer) => {
+      clearTimeout(timer);
+    });
+    this.editAutoSaveTimers = {};
     this.unregisterFromRefList();
   },
   methods: {
@@ -942,6 +959,430 @@ modules = {
       let o = widget.options.name;
       return (widget.options.keyNameEnabled && widget.options.keyName) || o;
     },
+    /** @param {Object} obj VXE 单元格参数。@returns {Object|null} 当前单元格实际使用的编辑组件 schema。 */
+    getClipboardCellWidget(obj) {
+      const params = obj?.column?.params || {};
+      const template = params.editWidget || params.widget;
+      if (!template) return null;
+      const rowSchema = this.getRowFieldSchema(obj.row);
+      return rowSchema?.[template.id] || template;
+    },
+    /** @param {Object} obj VXE 单元格参数。@returns {Boolean} 粘贴是否可以修改该单元格。 */
+    canPasteTableCell(obj) {
+      const column = obj?.column;
+      if (!column?.editRender || column.editRender.enabled === false) {
+        return false;
+      }
+      const widget = this.getClipboardCellWidget(obj);
+      if (widget?.options?.disabled || widget?.options?.readonly) {
+        return false;
+      }
+      if (!this.isTableCellEditable(obj)) {
+        return false;
+      }
+      const editOpts = obj?.$table?.editOpts || {};
+      const beforeEditMethod = editOpts.beforeEditMethod || editOpts.activeMethod;
+      return !beforeEditMethod || beforeEditMethod(obj) !== false;
+    },
+    /**
+     * 把剪贴板里的展示文本转换成字段真实值。选项列按 label 反查 value，避免从表格
+     * 复制出的中文标签直接写进 code 字段。
+     * @param {Object} widget 字段组件 schema。
+     * @param {*} cellValue 剪贴板文本。
+     * @returns {{accepted: Boolean, value: *}}
+     */
+    resolveTablePasteValue(widget, cellValue) {
+      const type = widget?.type;
+      const options = widget?.options || {};
+      const text = cellValue == null ? "" : String(cellValue).trim();
+      if (type === "number") {
+        if (!text) return { accepted: true, value: null };
+        return isNaN(text)
+          ? { accepted: false, value: null }
+          : { accepted: true, value: Number(text) };
+      }
+
+      const isMultiple = type === "checkbox"
+        || (type === "select" && options.multiple);
+      const isOptionWidget = ["select", "radio", "checkbox", "status"]
+        .includes(type);
+      if (!isOptionWidget) {
+        return { accepted: true, value: cellValue };
+      }
+
+      const items = type === "status"
+        ? options.statusParam || []
+        : options.optionItems || [];
+      const labelKey = this.getOptionItemLabelKey(widget);
+      const valueKey = this.getOptionItemValueKey(widget);
+      if (!text) {
+        return { accepted: true, value: isMultiple ? [] : null };
+      }
+      const parts = isMultiple ? text.split(/[,，;；\n\r]+/) : [text];
+      const values = [];
+      for (let index = 0; index < parts.length; index++) {
+        const part = parts[index].trim();
+        const matched = items.find(
+          (item) =>
+            String(this.$t1(item[labelKey])) === part
+            || String(item[valueKey]) === part
+        );
+        if (!matched) return { accepted: false, value: null };
+        values.push(matched[valueKey]);
+      }
+      return {
+        accepted: true,
+        value: isMultiple ? values : values[0],
+      };
+    },
+    /** @param {Object} obj VXE 单元格参数。@returns {Boolean} 是否为附件编辑列。 */
+    isClipboardAttachmentCell(obj) {
+      const widget = this.getClipboardCellWidget(obj);
+      return !!widget && isAttachmentWidgetType(widget.type);
+    },
+    /**
+     * @param {Object} obj VXE 单元格参数。
+     * @param {File[]} files 剪贴板文件。
+     * @returns {Promise<Boolean>} 至少一个附件上传成功时为 true。
+     */
+    pasteTableAttachments(obj, files) {
+      if (!files.length || !this.$baseUpload?.upload) {
+        return Promise.resolve(false);
+      }
+      const widget = this.getClipboardCellWidget(obj);
+      const options = widget?.options || {};
+      const field = obj.column.field;
+      const currentRows = normalizeAttachmentValue(obj.row[field]);
+      const limit = Number(options.limit) || 0;
+      const remaining = limit
+        ? Math.max(limit - currentRows.length, 0)
+        : files.length;
+      const acceptedFiles = files.slice(0, remaining);
+      if (!acceptedFiles.length) {
+        this.$message.warning(this.$t1("附件数量已达到上限"));
+        return Promise.resolve(false);
+      }
+
+      const tasks = acceptedFiles.map((file) => new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+          if (settled) return;
+          settled = true;
+          resolve(result);
+        };
+        try {
+          const requestTask = this.$baseUpload.upload({
+            file,
+            isLoading: true,
+            callback: (res) => {
+              if (!res || res.type !== "success") {
+                this.$message.error(
+                  res?.content
+                    || this.$t1("[{name}]上传失败", { name: file.name })
+                );
+                finish(false);
+                return;
+              }
+              const attachment = res.objx || {};
+              attachment.name = attachment.name || file.name;
+              const rows = normalizeAttachmentValue(obj.row[field]).slice();
+              if (limit && rows.length >= limit) {
+                finish(false);
+                return;
+              }
+              rows.push(attachment);
+              this.$set(obj.row, field, toModelValue(rows, options));
+              this.$nextTick(() => obj.$table?.updateFooter());
+              finish(true);
+            },
+          });
+          if (requestTask && typeof requestTask.catch === "function") {
+            requestTask.catch((error) => {
+              this.$message.error(
+                error?.message
+                  || this.$t1("[{name}]上传失败", { name: file.name })
+              );
+              finish(false);
+            });
+          }
+        } catch (error) {
+          this.$message.error(
+            error?.message || this.$t1("[{name}]上传失败", { name: file.name })
+          );
+          finish(false);
+        }
+      }));
+      return Promise.all(tasks).then((results) => results.some(Boolean));
+    },
+    /** @param {Object} obj VXE 单元格参数。@returns {Boolean|Promise<Boolean>} 是否修改了单元格。 */
+    pasteTableCell(obj) {
+      if (!this.canPasteTableCell(obj)) return false;
+      if (this.isClipboardAttachmentCell(obj)) {
+        if (!this.widget.options.clipboardAttachmentEnabled) return false;
+        // 文件必须在原生 paste 事件的同步调用栈中读取，异步后浏览器会清掉该数据。
+        const event = window.event;
+        const clipboardData = obj.clipData?.clipboardData
+          || event?.clipboardData
+          || window.clipboardData;
+        const files = clipboardData
+          ? Array.from(clipboardData.files || [])
+          : [];
+        return this.pasteTableAttachments(obj, files);
+      }
+      const widget = this.getClipboardCellWidget(obj);
+      const resolved = this.resolveTablePasteValue(widget, obj.cellValue);
+      if (resolved.accepted) {
+        this.$set(obj.row, obj.column.field, resolved.value);
+        return true;
+      }
+      if (this.widget.options.clipboardInvalidValueStrategy === "warn") {
+        this.$message.warning(
+          `字段 ${obj.column.title || obj.column.field} 的粘贴值无效，已跳过。`
+        );
+      }
+      return false;
+    },
+    /**
+     * @param {Object} $table VXE Table 实例。
+     * @param {Array<Object>} rows 本次粘贴实际修改的行。
+     * @description 按顺序复用单行保存，避免并发触发行保存锁。
+     */
+    async autoSaveClipboardRows($table, rows) {
+      const savedKeys = new Set();
+      for (const sourceRow of rows || []) {
+        const rowKey = sourceRow?._X_ROW_KEY;
+        if (rowKey && savedKeys.has(rowKey)) continue;
+        if (rowKey) savedKeys.add(rowKey);
+        const formRows = this.formModel[this.fieldKeyName] || [];
+        const row = rowKey
+          ? formRows.find((item) => item?._X_ROW_KEY === rowKey) || sourceRow
+          : sourceRow;
+        await this.saveEditRow(
+          { row, $table },
+          { skipConfirm: true }
+        );
+      }
+    },
+    /** @returns {Boolean} 是否开启编辑表格自动保存，兼容早期粘贴专用配置名。 */
+    isTableAutoSaveEnabled() {
+      const options = this.widget.options;
+      return !!(
+        options.autoSaveEnabled
+        || options.clipboardAutoSaveEnabled
+      );
+    },
+    /** @param {String} trigger 触发来源。@returns {Boolean} 当前来源是否启用自动保存。 */
+    isAutoSaveTriggerEnabled(trigger) {
+      const triggers = this.widget.options.autoSaveTrigger;
+      if (!Array.isArray(triggers)) {
+        return true;
+      }
+      return triggers.includes(trigger);
+    },
+    /**
+     * @param {Object} obj 行内字段携带的 VXE 单元格参数。
+     * @returns {Boolean} 是否已安排自动保存。
+     * @description 失焦后短延迟保存；同一行重复失焦会合并为一次请求。
+     */
+    scheduleEditRowAutoSave(obj, trigger = "blur") {
+      if (
+        !this.widget.options.isEditTable
+        || !this.isTableAutoSaveEnabled()
+        || !this.isAutoSaveTriggerEnabled(trigger)
+        || !obj?.row
+        || !obj?.$table
+        || !this.isTableCellEditable(obj, true)
+      ) {
+        return false;
+      }
+      const editSnapshot = obj.$table.editCloneRow;
+      if (
+        editSnapshot
+        && this.$baseLodash.isEqual(editSnapshot, obj.row)
+      ) {
+        return false;
+      }
+      const rowKey = obj.row._X_ROW_KEY || "current";
+      const configuredDelay = Number(this.widget.options.autoSaveDelay);
+      const autoSaveDelay = Number.isFinite(configuredDelay)
+        ? Math.max(configuredDelay, 0)
+        : 200;
+      clearTimeout(this.editAutoSaveTimers[rowKey]);
+      this.editAutoSaveTimers[rowKey] = setTimeout(() => {
+        delete this.editAutoSaveTimers[rowKey];
+        const runSave = async () => {
+          const rows = this.formModel[this.fieldKeyName] || [];
+          const currentRow = obj.row._X_ROW_KEY
+            ? rows.find((row) => row?._X_ROW_KEY === obj.row._X_ROW_KEY)
+              || obj.row
+            : obj.row;
+          return this.saveEditRow(
+            { ...obj, row: currentRow },
+            { skipConfirm: true }
+          );
+        };
+        this.editAutoSaveQueue = Promise.resolve(this.editAutoSaveQueue)
+          .catch(() => false)
+          .then(runSave)
+          .catch((error) => {
+            this.$message.error(error?.message || "失焦自动保存失败。");
+            return false;
+          });
+      }, autoSaveDelay);
+      return true;
+    },
+    /**
+     * @param {Object} $table VXE 表实例。
+     * @param {Array<String>} insertedRowKeys 本次粘贴自动补出的稳定行键。
+     * @description 把自动补出的行同步回 xform 表单模型。树表的 fullData 只有根节点，
+     * 因此只能合并本次新增节点，不能用它覆盖规范扁平数据。
+     */
+    syncClipboardTableRows($table, insertedRowKeys = []) {
+      if (this.widget.options.isTreeTable) {
+        if (!insertedRowKeys.length) return;
+        const visibleRows = $table?.afterFullData || [];
+        const keySet = new Set(insertedRowKeys);
+        const insertedRows = visibleRows.filter(
+          (row) => row?._X_ROW_KEY && keySet.has(row._X_ROW_KEY)
+        );
+        const formRows = Array.isArray(this.formModel[this.fieldKeyName])
+          ? this.formModel[this.fieldKeyName]
+          : [];
+        const existingKeys = new Set(formRows.map((row) => row?._X_ROW_KEY));
+        const nextRows = formRows.concat(
+          insertedRows.filter((row) => !existingKeys.has(row._X_ROW_KEY))
+        );
+        this.$set(this.formModel, this.fieldKeyName, nextRows);
+        this.initRowIdData();
+        this.initFieldSchemaData();
+        return;
+      }
+      const rows = $table?.getTableData()?.fullData || [];
+      let formRows = this.formModel[this.fieldKeyName];
+      if (!Array.isArray(formRows)) {
+        this.$set(this.formModel, this.fieldKeyName, rows);
+        this.fieldModel = rows;
+        return;
+      }
+      if (formRows !== rows) {
+        formRows.splice(0, formRows.length);
+        formRows.push(...rows);
+      }
+      this.fieldModel = formRows;
+      this.initRowIdData();
+      this.initFieldSchemaData();
+    },
+    /** @returns {Object} xform 编辑表的区域复制粘贴配置。 */
+    buildTableClipboardConfig() {
+      const options = this.widget.options;
+      if (!options.isEditTable || !options.clipboardEnabled) {
+        return {};
+      }
+      let insertedRowKeys = [];
+      let pasteBatch = null;
+      const excludeFields = Array.from(new Set([
+        "operate",
+        ...(Array.isArray(options.clipboardExcludeFields)
+          ? options.clipboardExcludeFields
+          : []),
+      ]));
+      return {
+        mouseConfig: { area: true },
+        areaConfig: {
+          multiple: false,
+          excludeFields,
+          selectCellByHeader: false,
+        },
+        keyboardConfig: {
+          isClip: true,
+          isEdit: true,
+          isDel: false,
+          isEsc: true,
+        },
+        clipConfig: {
+          isCopy: true,
+          isPaste: true,
+          isCut: false,
+          excludeFields,
+          isRowIncrement: !!options.clipboardRowIncrementEnabled,
+          beforePasteMethod: () => {
+            pasteBatch = {
+              rows: new Map(),
+              tasks: [],
+            };
+          },
+          createRowsMethod: ({ insertRows, targetRow }) => {
+            insertedRowKeys = [];
+            const treeContext = options.isTreeTable
+              ? this.getTreeContext()
+              : null;
+            const rows = insertRows.map(() => {
+              const row = {
+                ...this.createNewTableData(true),
+                _X_ROW_KEY: "row_" + generateId(),
+              };
+              if (treeContext) {
+                row[treeContext.identityConfig.physicalIdField] = null;
+                this.ensureNewTreeRowKey(row, treeContext);
+                const insertMode = options.treePasteInsertMode || "root";
+                const siblingParent = targetRow
+                  ? targetRow[treeContext.fields.parentField]
+                  : treeContext.identityConfig.rootParentValue;
+                row[treeContext.fields.parentField]
+                  = insertMode === "sibling"
+                    ? siblingParent
+                    : treeContext.identityConfig.rootParentValue;
+              }
+              insertedRowKeys.push(row._X_ROW_KEY);
+              return row;
+            });
+            if (treeContext) {
+              this.validateNewTreeRows(rows, treeContext);
+            }
+            return rows;
+          },
+          pasteMethod: (obj) => {
+            const batch = pasteBatch;
+            const rememberRow = () => {
+              if (!batch) return;
+              const key = obj.row?._X_ROW_KEY || obj.row;
+              batch.rows.set(key, obj.row);
+            };
+            const result = this.pasteTableCell(obj);
+            if (result && typeof result.then === "function") {
+              batch?.tasks.push(
+                Promise.resolve(result).then((changed) => {
+                  if (changed) rememberRow();
+                })
+              );
+            } else if (result) {
+              rememberRow();
+            }
+          },
+          afterPasteMethod: ({ $table }) => {
+            $table.clearActived();
+            this.syncClipboardTableRows($table, insertedRowKeys);
+            insertedRowKeys = [];
+            const batch = pasteBatch;
+            pasteBatch = null;
+            if (
+              this.isTableAutoSaveEnabled()
+              && this.isAutoSaveTriggerEnabled("paste")
+              && batch
+            ) {
+              Promise.all(batch.tasks)
+                .then(() => this.autoSaveClipboardRows(
+                  $table,
+                  Array.from(batch.rows.values())
+                ))
+                .catch((error) => {
+                  this.$message.error(error?.message || "粘贴后自动保存失败。");
+                });
+            }
+          },
+        },
+      };
+    },
     /** @returns {String} 数据集必填校验提示。 */
     getDatasetRequiredHint() {
       if (this.widget.options.requiredHint) {
@@ -2418,13 +2859,13 @@ modules = {
       let pagerConfig = {};
       let editDefaultRow, treeNodeParam, treeConfig;
       let isTreeTable = this.widget.options.isTreeTable;
+      if (this.widget.options.editDefaultRow) {
+        editDefaultRow = this.handleCustomEvent(
+          this.widget.options.editDefaultRow
+        );
+      }
       if (isTreeTable) {
-        pagerConfig.pagerClass = "is--hidden";
-        if (this.widget.options.editDefaultRow) {
-          editDefaultRow = this.handleCustomEvent(
-            this.widget.options.editDefaultRow
-          );
-        }
+        const configuredTree = this.widget.options.treeConfig || {};
         treeConfig = {
           lazy: false,
           // 树表主键列显式声明为唯一事实源：vxe transform 建树(toArrayTree)
@@ -2441,6 +2882,8 @@ modules = {
           // 所有行，vxe 按引用匹配的展开记录会全部失效。reserve 按 _X_ROW_KEY
           // 恢复展开状态（克隆保留该键），查询重载会重新生成键，互不干扰。
           reserve: true,
+          ...configuredTree,
+          transform: true,
           loadMethod: ({ $table, row }) => {
             // 模拟后台接口
             let $grid = that.getGridTable();
@@ -2610,6 +3053,7 @@ modules = {
           // editRules
         };
       }
+      const clipboardOpts = this.buildTableClipboardConfig();
       let showFooter = this.widget.options.showGridFooter || false;
       let otherConfig = {};
       if (this.widget.options.hideGridCheckBox) {
@@ -2682,14 +3126,17 @@ modules = {
         };
       }
       let hostTreeIdentityConfig = {
+        ...(this.widget.options.treeIdentityConfig || {}),
         ...(dataTableConfig.otherConfig?.treeIdentityConfig || {}),
         ...(dataTableConfig.treeIdentityConfig || {}),
       };
       let hostTreeCopyConfig = {
+        ...(this.widget.options.treeCopyConfig || {}),
         ...(dataTableConfig.otherConfig?.treeCopyConfig || {}),
         ...(dataTableConfig.treeCopyConfig || {}),
       };
       let hostTreeSubmitConfig = {
+        ...(this.widget.options.treeSubmitConfig || {}),
         ...(dataTableConfig.otherConfig?.treeSubmitConfig || {}),
         ...(dataTableConfig.treeSubmitConfig || {}),
       };
@@ -2702,6 +3149,7 @@ modules = {
         columns: columns,
         searchColumns: searchColumns,
         isQueryAllPage,
+        readQueryAllPage: !this.widget.options.isNotReadQueryAllPage,
         exportItemConfig,
         vform: true,
         ...(this.getDynamicColumnSourceType() !== "none"
@@ -2718,11 +3166,14 @@ modules = {
         config: {
           height: height,
           showFooter,
-          pagerConfig,
+          pagerConfig: this.widget.options.showPagination
+            ? pagerConfig
+            : false,
           treeConfig,
           rowConfig,
           headerCellStyle,
           ...editOpts,
+          ...clipboardOpts,
           ...hostTableConfig,
 
           /*rowConfig:{
@@ -2820,7 +3271,7 @@ modules = {
                   });
                 }
 
-                if (page.pageSize !== undefined) {
+                if (page && page.pageSize !== undefined) {
                   queryParams["size"] = page.pageSize;
                   queryParams["current"] = page.currentPage;
                 }
@@ -3680,8 +4131,10 @@ modules = {
     async deleteRow(row, rowIndex) {
       let isTreeTable = this.widget.options.isTreeTable;
       if (isTreeTable) {
-        this.removeTreeRow({ row });
-        return;
+        return this.removeTreeRow({ row, rowIndex });
+      }
+      if (!this.canDeleteTableRow({ row, rowIndex })) {
+        return false;
       }
       delete this.fieldSchemaMap[row._X_ROW_KEY];
       let $grid = this.getGridTable();
@@ -4482,15 +4935,18 @@ modules = {
     /**
      * 保存当前编辑行。持久化行原位合并；新身份以回查结果重建树关系。
      * @param {Object} obj VXE 插槽参数，必须包含 row 和 $table。
+     * @param {Object} options 保存选项；skipConfirm 用于粘贴后的自动保存。
      */
-    async saveEditRow(obj) {
+    async saveEditRow(obj, options = {}) {
       let formRef = this.getFormRef();
       let formConfig = this.formConfig;
       let entity = formConfig.entity;
       if (!entity) return;
       let reportTemplate = formRef?.reportTemplate;
       let formCode = reportTemplate?.formCode;
-      let scriptCode = formConfig.saveScriptCode || "saveUpdate";
+      let scriptCode = this.widget.options.rowSaveScriptCode
+        || formConfig.saveScriptCode
+        || "saveUpdate";
 
       let $grid = obj.$table.$xegrid;
       if (typeof this.treeSingleSaveReconcileTask === "function") {
@@ -4543,6 +4999,12 @@ modules = {
         const rowValid = controlled ? await this.validateEditRowAsync(obj.row) : this.validateEditRow(obj.row);
         if (!rowValid) return false;
         const fieldControlSnapshot = controlled ? formRef.captureFieldControlSubmission() : null;
+        const beforeSaveResult = this.handleCustomEvent(
+          this.widget.options.beforeRowSave,
+          ["rowData", "tableParam"],
+          [obj.row, obj]
+        );
+        if (beforeSaveResult === false) return false;
 
         let requestRow = obj.row;
         if (treeContext) {
@@ -4612,10 +5074,12 @@ modules = {
           );
         }
 
-        try {
-          await this.$baseConfirm("您确定要保存吗？");
-        } catch (error) {
-          return false;
+        if (!options.skipConfirm) {
+          try {
+            await this.$baseConfirm("您确定要保存吗？");
+          } catch (error) {
+            return false;
+          }
         }
 
         await $grid.clearActived();
@@ -4638,8 +5102,8 @@ modules = {
         let urlValueProps = this.getUrlValueAttachmentProps();
         Object.keys(mainData).forEach((key) => {
           if (
-            key.startsWith("attachments_") &&
-            urlValueProps.indexOf(key) === -1
+            key.startsWith("attachments_")
+            && urlValueProps.indexOf(key) === -1
           ) {
             formData[key] = mainData[key];
           }
@@ -4848,6 +5312,11 @@ modules = {
             await $grid.updateData();
           }
           delete obj.$table.editCloneRow;
+          this.handleCustomEvent(
+            this.widget.options.afterRowSave,
+            ["rowData", "res"],
+            [obj.row, rowResponse]
+          );
           return true;
         };
         let runRowReconcile = async () =>
@@ -4855,6 +5324,7 @@ modules = {
         try {
           return await runRowReconcile();
         } catch (error) {
+          this.handleRowSaveError(error, obj.row);
           keepSaveLocked = true;
           let retryPromise = null;
           this.treeSingleSaveReconcileTask = () => {
@@ -4884,6 +5354,7 @@ modules = {
           return false;
         }
       } catch (error) {
+        this.handleRowSaveError(error, obj.row);
         if (error?.treeReloadFailed) {
           keepSaveLocked = true;
           installReloadRetry();
@@ -4904,6 +5375,18 @@ modules = {
         }
       }
     },
+    /** @param {Error} error 保存异常。@param {Object} rowData 当前行。执行保存失败脚本。 */
+    handleRowSaveError(error, rowData) {
+      try {
+        this.handleCustomEvent(
+          this.widget.options.onRowSaveError,
+          ["error", "rowData"],
+          [error, rowData]
+        );
+      } catch (hookError) {
+        // 自定义失败脚本自身报错时保留原保存异常，由统一错误提示负责展示。
+      }
+    },
     /** @param {*} dataId 行数据 id。@param {Function} callback 查询成功回调。加载保存后的完整行。 */
     getRowData(dataId, callback, fail, error) {
       let reportTemplate = this.getFormRef()?.reportTemplate;
@@ -5235,6 +5718,9 @@ modules = {
      * @param {Object} obj VXE 行参数。
      */
     removeTreeRow(obj) {
+      if (!this.canDeleteTableRow(obj)) {
+        return false;
+      }
       let row = obj.row;
       let tableRows = this.getValue() || [];
       let delKeys = this.collectDescendantKeys(row, tableRows);
@@ -5248,6 +5734,9 @@ modules = {
      * @param {Object} obj VXE 行参数。
      */
     removeChildTreeRows(obj) {
+      if (!this.canDeleteTableRow(obj)) {
+        return false;
+      }
       let row = obj.row;
       let tableRows = this.getValue() || [];
       let delKeys = this.collectDescendantKeys(row, tableRows);
@@ -5281,8 +5770,17 @@ modules = {
     },
     /** @param {Object} obj VXE 单元格参数。@returns {Object} 行新增/编辑按钮配置。 */
     getEditTreeButtonGroupConfig(obj) {
-      let columnConfig = obj?.column?.params?.columnConfig || {};
       let tableOptions = this.widget.options || {};
+      let columnConfig = obj?.column?.params?.columnConfig || {};
+      if (columnConfig.formatS !== "editTreeButtonGroup") {
+        let actionColumn = null;
+        this.loodHandleColumns(tableOptions.tableColumns || [], (column) => {
+          if (!actionColumn && column?.formatS === "editTreeButtonGroup") {
+            actionColumn = column;
+          }
+        });
+        columnConfig = actionColumn || columnConfig;
+      }
       return {
         rowAddAuthName: columnConfig.rowAddAuthName,
         rowEditAuthName: columnConfig.rowEditAuthName,
@@ -5314,11 +5812,30 @@ modules = {
       let result = this.handleCustomEvent(script, ["tableParam"], [obj]);
       return result !== false;
     },
+    /** @param {String|Function} script 行级条件脚本。@param {Object} obj VXE 行参数。@returns {Boolean} */
+    isTableRowConditionAllowed(script, obj) {
+      if (!script) {
+        return true;
+      }
+      try {
+        return this.handleCustomEvent(
+          script,
+          ["tableParam"],
+          [obj]
+        ) !== false;
+      } catch (error) {
+        return false;
+      }
+    },
     /** @param {Object} obj VXE 行参数。@returns {Boolean} 是否显示行新增按钮。 */
     canShowRowAdd(obj) {
       return (
-        this.hasTableRowPermission(this.getRowAddAuthName(obj)) &&
-        this.isRowButtonShow(this.getRowAddShow(obj), obj)
+        this.hasTableRowPermission(this.getRowAddAuthName(obj))
+        && this.isRowButtonShow(this.getRowAddShow(obj), obj)
+        && this.isTableRowConditionAllowed(
+          this.widget.options.rowAddableScript,
+          obj
+        )
       );
     },
     /** @param {Object} obj VXE 行参数。@returns {Boolean} 是否显示行编辑按钮。 */
@@ -5326,10 +5843,50 @@ modules = {
       let isAddRow = !this.hasSaveRow(obj?.row);
       if (isAddRow) return true;
       return (
-        this.hasTableRowPermission(this.getRowEditAuthName(obj)) &&
-        this.isRowButtonShow(this.getRowEditShow(obj), obj)
+        this.hasTableRowPermission(this.getRowEditAuthName(obj))
+        && this.isRowButtonShow(this.getRowEditShow(obj), obj)
+        && this.isTableRowConditionAllowed(
+          this.widget.options.rowEditableScript,
+          obj
+        )
       );
     },
+    /** @param {Object} obj VXE 行参数。@returns {Boolean} 当前行是否允许删除。 */
+    canDeleteTableRow(obj) {
+      return this.isTableRowConditionAllowed(
+        this.widget.options.rowDeletableScript,
+        obj
+      );
+    },
+    /**
+     * @param {Object} obj VXE 单元格参数。
+     * @param {Boolean} useEditSnapshot true 时按进入编辑时的原始状态判断。
+     * @returns {Boolean} 当前行、当前字段是否允许修改。
+     */
+    isTableCellEditable(obj, useEditSnapshot = false) {
+      const rowParams = useEditSnapshot && obj?.$table?.editCloneRow
+        ? { ...obj, row: obj.$table.editCloneRow }
+        : obj;
+      if (!this.canShowRowEdit(rowParams)) {
+        return false;
+      }
+      const columnConfig = obj?.column?.params?.columnConfig || {};
+      const script = columnConfig.cellEditable;
+      if (!script) {
+        return true;
+      }
+      try {
+        const result = this.handleCustomEvent(
+          script,
+          ["tableParam", "columnConfig"],
+          [rowParams, columnConfig]
+        );
+        return result !== false;
+      } catch (error) {
+        // 条件脚本异常时按不可编辑处理，避免渲染阶段放开字段修改。
+        return false;
+      }
+    },
     /** @param {Object} obj VXE 行参数。保存编辑前快照并激活该行。 */
     editRowEvent(obj) {
       if (!this.canShowRowEdit(obj)) {
@@ -5578,6 +6135,9 @@ modules = {
      * @param {Object} obj VXE 行参数。
      */
     async removeEditRow(obj) {
+      if (!this.canDeleteTableRow(obj)) {
+        return false;
+      }
       let row = obj.row;
       let $grid = this.getGridTable();
       await $grid.remove(row);