@dazhicheng/ui 1.5.265 → 1.6.0

package/dist/components/tt-table/src/utils/table-api.js

@@ -1,179 +1,126 @@
-var K = Object.defineProperty;
-var A = (a, e, t) => e in a ? K(a, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[e] = t;
-var s = (a, e, t) => A(a, typeof e != "symbol" ? e + "" : e, t);
+var u = Object.defineProperty;
+var c = (r, t, e) => t in r ? u(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var a = (r, t, e) => c(r, typeof t != "symbol" ? t + "" : t, e);
 import "axios";
 import "element-plus";
-import { isFunction as H } from "../../../../packages/utils/src/is.js";
-import { reactive as l, computed as r } from "vue";
-import { bindMethods as I } from "../../../../packages/utils/src/tool.js";
-import { mergeWithArrayOverride as n } from "../../../../packages/utils/src/merge.js";
+import { isFunction as w } from "../../../../packages/utils/src/is.js";
+import { reactive as m, shallowRef as y, computed as n, toValue as d } from "vue";
+import { bindMethods as p } from "../../../../packages/utils/src/tool.js";
+import { mergeWithArrayOverride as h } from "../../../../packages/utils/src/merge.js";
 import "../../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
-import { StateHandler as k } from "../../../../packages/utils/src/stateHandler.js";
+import { StateHandler as g } from "../../../../packages/utils/src/stateHandler.js";
 import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/aes.js";
 import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/enc-utf8.js";
 import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/mode-ecb.js";
 import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/pad-pkcs7.js";
 import "lodash-es";
 import { GlobalConfig as o } from "../../../../hooks/useSetup.js";
-import { Store as z } from "@tanstack/vue-store";
-function M() {
-  var a, e, t, i, d, h, m, u, c, p, g, w, f, b, y, S, C, x, R, T, v, E, P, D, F;
+import { createSharedTableDefaults as R } from "../table-defaults.js";
+import { Store as b } from "@tanstack/vue-store";
+function C() {
+  var r, t, e, s, i, l;
   return {
-    showPager: !0,
-    total: 0,
-    showCheckbox: !1,
-    showExpand: !1,
-    showRadio: !1,
-    showIndex: !1,
-    isCellResize: !1,
-    isColumnsDrag: !1,
-    isCellSort: !1,
-    showAction: !1,
-    actionWidth: 0,
-    actionTitle: "",
-    actionProps: {},
-    indexColumnProps: {},
-    checkboxColumnProps: {},
-    expandColumnProps: {},
-    radioColumnProps: {},
-    searchInfo: {},
-    immediate: !0,
+    ...R(),
     loading: !1,
-    showToolbar: !1,
-    columnsFieldSort: [],
-    columnsFieldNoSort: [],
-    notSetColumnField: [],
-    filterNoVisibleField: [],
-    showTableAlert: !1,
-    modelValue: [],
-    title: "",
-    showTitle: !1,
+    /**
+     * hook 方式默认不铺满，与 `props.ts` 的组件方式默认 `true` 有意不同，不要统一：
+     * 改任一边都会改变现有页面的表格高度。
+     */
     autoHeight: !1,
-    leftSlotWidth: 0,
-    rightSlotWidth: 0,
-    emptyImageStyle: {},
-    isHanderSubmit: !1,
-    treeNode: !1,
-    clearTreeExpand: !0,
-    isI18n: !0,
-    isDataCloneDeep: !0,
-    showOverflow: !0,
-    height: void 0,
-    showHeaderOverflow: !0,
-    isScrollFetch: !1,
-    showScrollFetchLoading: !0,
-    toolbarConfig: void 0,
-    zoomConfig: void 0,
-    formApi: void 0,
-    useHttpCache: (a = o.table) == null ? void 0 : a.useHttpCache,
-    defaultDisplayFields: (e = o.table) == null ? void 0 : e.defaultDisplayFields,
-    loadingText: (t = o.table) == null ? void 0 : t.loadingText,
-    emptyText: (i = o.table) == null ? void 0 : i.emptyText,
-    emptyImageStatus: "no-data",
-    noSearchText: (d = o.table) == null ? void 0 : d.noSearchText,
-    showSetColumn: (h = o.table) == null ? void 0 : h.showSetColumn,
-    showSetting: (m = o.table) == null ? void 0 : m.showSetting,
-    showRefresh: (u = o.table) == null ? void 0 : u.showRefresh,
-    tableRowId: (c = o.table) == null ? void 0 : c.tableRowId,
-    currentPageField: (p = o.table) == null ? void 0 : p.currentPageField,
-    pageSizeField: (g = o.table) == null ? void 0 : g.pageSizeField,
-    totalField: (w = o.table) == null ? void 0 : w.totalField,
-    dataField: (f = o.table) == null ? void 0 : f.dataField,
-    pagerConfig: (b = o.table) == null ? void 0 : b.pagerConfig,
-    size: (y = o.table) == null ? void 0 : y.size,
-    keyboardConfig: (S = o.table) == null ? void 0 : S.keyboardConfig,
-    menuConfig: {},
-    mouseConfig: (C = o.table) == null ? void 0 : C.mouseConfig,
-    checkboxConfig: (x = o.table) == null ? void 0 : x.checkboxConfig,
-    radioConfig: (R = o.table) == null ? void 0 : R.radioConfig,
-    stripe: (T = o.table) == null ? void 0 : T.stripe,
-    border: (v = o.table) == null ? void 0 : v.border,
-    updateColumnsApi: (E = o.table) == null ? void 0 : E.updateColumnsApi,
-    getColumnsApi: (P = o.table) == null ? void 0 : P.getColumnsApi,
-    setColumnsApi: (D = o.table) == null ? void 0 : D.setColumnsApi,
-    columnsKey: (F = o.table) == null ? void 0 : F.columnsKey
+    stripe: (r = o.table) == null ? void 0 : r.stripe,
+    border: (t = o.table) == null ? void 0 : t.border,
+    updateColumnsApi: (e = o.table) == null ? void 0 : e.updateColumnsApi,
+    getColumnsApi: (s = o.table) == null ? void 0 : s.getColumnsApi,
+    setColumnsApi: (i = o.table) == null ? void 0 : i.setColumnsApi,
+    /**
+     * hook 方式取全局配置，与 `props.ts` 的组件方式固定取 `""` 有意不同，不要统一：
+     * 统一会改变组件方式下的列配置缓存 key，已存的服务端列配置会读不到。
+     */
+    columnsKey: (l = o.table) == null ? void 0 : l.columnsKey
   };
 }
-class $ {
+class k {
   /**
    * 构造函数，初始化 store、状态等
    * @param options 表格配置项
    */
-  constructor(e = {}) {
+  constructor(t = {}) {
     /** vxe-grid 表格实例 */
-    s(this, "grid", l({}));
+    a(this, "grid", m({}));
     /** 表格操作方法集合（TtTableMethods） */
-    s(this, "methods", l({}));
+    a(this, "methods", m({}));
     /** 当前表格的 props 状态 */
-    s(this, "state", null);
+    a(this, "state", null);
     /** 响应式 store，存储表格的状态 */
-    s(this, "store");
-    /** 响应式代理状态（loading、selectedKeys） */
-    s(this, "proxyState", l({
-      loading: !1,
-      selectedKeys: [],
-      isTableEvent: !1,
-      selectedRows: []
-    }));
-    s(this, "isMounted", !1);
-    s(this, "stateHandler");
+    a(this, "store");
+    /** 组件内的响应式状态源（loading、行选择），挂载时由组件交进来 */
+    a(this, "stateSources", y(null));
+    a(this, "isMounted", !1);
+    a(this, "stateHandler");
     /**
-     * @description: 获取表格选中数据
-     * @return {DT[]}
+     * @description: 获取表格选中数据的keys（响应式）
      */
-    s(this, "selectedKeys", r(() => this.proxyState.selectedKeys));
+    a(this, "selectedKeys", n(() => {
+      var t;
+      return d((t = this.stateSources.value) == null ? void 0 : t.selectedKeys) ?? [];
+    }));
     /**
-     * @description: 获取表格选中数据
-     * @return {DT[]}
+     * @description: 获取表格选中数据（响应式）
      */
-    s(this, "selectedRows", r(() => this.proxyState.selectedRows));
+    a(this, "selectedRows", n(() => {
+      var t;
+      return d((t = this.stateSources.value) == null ? void 0 : t.selectedRows) ?? [];
+    }));
     /**
      * 获取表格 loading 状态（响应式）
      */
-    s(this, "getLoading", r(() => this.proxyState.loading));
-    /**
-     * 是否使用表格的event
-     */
-    s(this, "getIsTableEvent", r(() => this.proxyState.isTableEvent));
-    const t = { ...e }, i = M();
-    this.store = new z(n(t, i), {
+    a(this, "getLoading", n(() => {
+      var t;
+      return d((t = this.stateSources.value) == null ? void 0 : t.loading) ?? !1;
+    }));
+    const e = { ...t }, s = C();
+    this.store = new b(h(e, s), {
       onUpdate: () => {
         this.state = this.store.state;
       }
-    }), this.state = this.store.state, this.stateHandler = new k(), I(this);
+    }), this.state = this.store.state, this.stateHandler = new g(), p(this);
   }
   /**
    * 组件挂载时调用，注入表格实例和方法
    * @param instance vxe-grid 实例
    * @param methods 表格操作方法
    */
-  mount(e, t) {
-    !this.isMounted && e && (Object.setPrototypeOf(this.grid, e), Object.setPrototypeOf(this.methods, t), this.stateHandler.setConditionTrue(), this.isMounted = !0);
+  mount(t, e) {
+    var s;
+    if (!this.isMounted && t) {
+      const i = ((s = e.getTableInstance) == null ? void 0 : s.call(e)) || t;
+      Object.setPrototypeOf(this.grid, i), Object.setPrototypeOf(this.methods, e), this.stateHandler.setConditionTrue(), this.isMounted = !0;
+    }
   }
   /**
    * 更新表格的状态
    * @param stateOrFn 新状态或返回新状态的函数
    */
-  setState(e) {
-    H(e) ? this.store.setState((t) => {
-      const i = e(t);
-      return n(i, t, ["searchInfo"]);
-    }) : this.store.setState((t) => n(e, t, ["searchInfo"]));
+  setState(t) {
+    w(t) ? this.store.setState((e) => {
+      const s = t(e);
+      return h(s, e, ["searchInfo"]);
+    }) : this.store.setState((e) => h(t, e, ["searchInfo"]));
   }
   /**
    * 组件卸载时调用，重置挂载状态
    */
   unmount() {
-    this.isMounted = !1, this.stateHandler.reset();
+    this.isMounted = !1, this.stateSources.value = null, Object.setPrototypeOf(this.grid, Object.prototype), Object.setPrototypeOf(this.methods, Object.prototype), this.stateHandler.reset();
   }
   /**
    * @description: 表格重载数据
    * @param {FetchParams | undefined} data 加载的params
    * @return {*}
    */
-  async reload(e) {
+  async reload(t) {
     try {
-      this.methods.reload(e);
+      await this.methods.reload(t);
     } catch {
     }
   }
@@ -181,8 +128,8 @@ class $ {
    * @description: 设置表格props
    * @param {Partial<TtTableProps>} props 表格props
    */
-  setProps(e) {
-    this.methods.setProps(e);
+  setProps(t) {
+    this.methods.setProps(t);
   }
   /**
    * @description: 重新计算高度
@@ -196,8 +143,8 @@ class $ {
    * @param {VxeGridPropTypes.Columns<DT>} columns columns
    * @return {*}
    */
-  setTableColumns(e) {
-    this.methods.setTableColumns(e);
+  setTableColumns(t) {
+    this.methods.setTableColumns(t);
   }
   /**
    * @description: 获取表格columns
@@ -217,8 +164,8 @@ class $ {
    * @description: 设置表格loading
    * @param {boolean} loading
    */
-  setLoading(e) {
-    this.methods.setLoading(e);
+  setLoading(t) {
+    this.methods.setLoading(t);
   }
   /**
    * @description: 获取表格pagination
@@ -231,8 +178,8 @@ class $ {
    * @description: 设置表格pagination
    * @param {Partial<VxeGridPropTypes.PagerConfig>} props 表格pagination
    */
-  setPagination(e) {
-    this.methods.setPagination(e);
+  setPagination(t) {
+    this.methods.setPagination(t);
   }
   /**
    * @description: 获取选中数据的keys集合
@@ -253,8 +200,8 @@ class $ {
    * @param {TtSelectRowsType[]} rows 选中的数据
    * @param {TtSelectRowKeysType[]} keys 选中的数据keys
    */
-  setSelectedRowKeys(e, t) {
-    this.methods.setSelectedRowKeys(e, t);
+  setSelectedRowKeys(t, e) {
+    this.methods.setSelectedRowKeys(t, e);
   }
   /**
    * @description: 清除全部行选择
@@ -266,8 +213,8 @@ class $ {
    * 往表格插入临时数据，从第一行新增一行或多行新数据
    * @param records 新数据
    */
-  async insert(e) {
-    return await this.methods.insert(e);
+  async insert(t) {
+    return await this.methods.insert(t);
   }
   /**
    * 往表格指定行中插入临时数据
@@ -277,15 +224,31 @@ class $ {
    * @param {Object/Array} records 新的数据
    * @param {Row} row 指定行
    */
-  async insertAt(e, t) {
-    return await this.methods.insertAt(e, t);
+  async insertAt(t, e) {
+    return await this.methods.insertAt(t, e);
+  }
+  /** 在指定行之后插入临时数据 */
+  async insertNextAt(t, e) {
+    return await this.methods.insertNextAt(t, e);
+  }
+  /** 在树节点下插入临时子数据 */
+  async insertChild(t, e) {
+    return await this.methods.insertChild(t, e);
+  }
+  /** 在树节点下的指定位置插入临时子数据 */
+  async insertChildAt(t, e, s) {
+    return await this.methods.insertChildAt(t, e, s);
+  }
+  /** 在树节点下的指定行之后插入临时子数据 */
+  async insertChildNextAt(t, e, s) {
+    return await this.methods.insertChildNextAt(t, e, s);
   }
   /**
    * 删除指定行数据，指定 row 或 [row, ...] 删除多条数据，如果为空则删除所有数据
    * @param rows 指定行
    */
-  async remove(e) {
-    return await this.methods.remove(e);
+  async remove(t) {
+    return await this.methods.remove(t);
   }
   /**
    * 删除复选框选中的行数据
@@ -305,48 +268,73 @@ class $ {
   async removeCurrentRow() {
     return await this.methods.removeCurrentRow();
   }
+  /**
+   * 删除所有新增的临时数据
+   */
+  async removeInsertRow() {
+    return await this.methods.removeInsertRow();
+  }
+  /** 清除表格的全部数据状态 */
+  async clearAll() {
+    return await this.methods.clearAll();
+  }
+  /**
+   * 重新加载 VXE 当前同步数据。
+   * @deprecated VXE 已废弃 syncData，请使用 reloadData 或 getDataSource。
+   */
+  async syncData() {
+    return await this.methods.syncData();
+  }
+  /** 重新计算 VXE 的数据视图 */
+  async updateData() {
+    return await this.methods.updateData();
+  }
+  /** 修改指定行数据 */
+  async setRow(t, e) {
+    return await this.methods.setRow(t, e);
+  }
   /**
    * 清除编辑状态并重置数据
    */
-  clearEditRevertData(e) {
-    this.methods.clearEditRevertData(e);
+  clearEditRevertData(t) {
+    this.methods.clearEditRevertData(t);
   }
   /**
    * 指定行激活编辑
-   * @param {VxeTablePropTypes.Row} row 行数据
+   * @param {Row} row 行数据
    * @param {string | VxeTableDefines.ColumnInfo} fieldOrColumn 列配置可以时field
    */
-  setEditRow(e, t) {
-    this.methods.setEditRow(e, t);
+  setEditRow(t, e) {
+    this.methods.setEditRow(t, e);
   }
   /**
    * 指定单元格激活编辑
-   * @param {VxeTablePropTypes.Row} row 当前行数据
+   * @param {Row} row 当前行数据
    * @param {string | VxeTableDefines.ColumnInfo} fieldOrColumn 列配置可以时field
    */
-  setEditCell(e, t) {
-    this.methods.setEditCell(e, t);
+  setEditCell(t, e) {
+    this.methods.setEditCell(t, e);
   }
   /**
    * 加载数据
    * @param data 数据
    */
-  async loadData(e) {
-    return await this.methods.loadData(e);
+  async loadData(t) {
+    return await this.methods.loadData(t);
   }
   /**
    * 加载数据并恢复到初始状态
    * @param data 数据
    */
-  async reloadData(e) {
-    return await this.methods.reloadData(e);
+  async reloadData(t) {
+    return await this.methods.reloadData(t);
   }
   /**
    * 重新加载列
    * @param columns 列对象
    */
-  async reloadColumn(e) {
-    return await this.methods.reloadColumn(e);
+  async reloadColumn(t) {
+    return await this.methods.reloadColumn(t);
   }
   /**
    * 局部加载行数据并恢复到初始状态
@@ -354,44 +342,89 @@ class $ {
    * @param record 新数据
    * @param field 指定字段名
    */
-  async reloadRow(e, t, i) {
-    return await this.methods.reloadRow(e, t, i);
+  async reloadRow(t, e, s) {
+    return await this.methods.reloadRow(t, e, s);
+  }
+  /** 还原 keep-source 保存的行数据 */
+  async revertData(t, e) {
+    return await this.methods.revertData(t, e);
+  }
+  /** 加载树节点的子数据 */
+  async loadTreeChildren(t, e) {
+    return await this.methods.loadTreeChildren(t, e);
   }
   /**
    * 手动清空单元格内容，如果不传参数，则清空整个表格内容，如果传了行则清空指定行内容，如果传了指定字段，则清空该字段内容
    * @param data 指定行
    * @param field 字段名
    */
-  async clearData(e, t) {
-    return await this.methods.clearData(e, t);
+  async clearData(t, e) {
+    return await this.methods.clearData(t, e);
+  }
+  /** 移动行到指定行位置 */
+  async moveRowTo(t, e, s) {
+    return await this.methods.moveRowTo(t, e, s);
+  }
+  /** 撤销最近一次数据操作 */
+  async undo() {
+    return await this.methods.undo();
+  }
+  /** 重做最近一次数据操作 */
+  async redo() {
+    return await this.methods.redo();
   }
   /**
    * 重新懒加载展开行，并展开内容
    * @param row 指定行
    */
-  reloadRowExpand(e) {
-    this.methods.reloadRowExpand(e);
+  async reloadRowExpand(t) {
+    return await this.methods.reloadRowExpand(t);
   }
   /**
    * 重新懒加载树节点，并展开该节点
    * @param row 指定行
    */
-  reloadTreeExpand(e) {
-    this.methods.reloadRowExpand(e);
+  async reloadTreeExpand(t) {
+    return await this.methods.reloadTreeExpand(t);
   }
   /** 获取表格实例 */
   getTableInstance() {
     return this.grid;
   }
   /**
-   * 设置代理状态（loading、selectedKeys）
-   * @param state 代理状态对象
+   * 校验表格编辑数据
+   * @param isFull true 时校验全部行并收集所有错误，缺省或 false 时遇到第一个错误即停止
+   * @returns 全部通过时为 undefined，否则为 vxe 原生形状的错误映射（以列字段为键）
+   */
+  async validate(t) {
+    return await this.methods.validate(t);
+  }
+  /**
+   * 校验指定行的指定字段
+   * @param row 行数据
+   * @param field 列字段名
+   */
+  async validateField(t, e) {
+    return await this.methods.validateField(t, e);
+  }
+  /**
+   * 设置空数据提示文字
+   * @param text 提示文字
+   */
+  setEmptyText(t) {
+    this.methods.setEmptyText(t);
+  }
+  /**
+   * 绑定组件内的响应式状态源
+   *
+   * 直接持有组件的 ref，读取时才取值，避免用 watch 把状态同步到 api 上。
+   * @param sources 状态源
    */
-  setProxyState(e) {
-    this.proxyState.selectedKeys = e.selectedKeys ?? this.proxyState.selectedKeys, this.proxyState.loading = e.loading ?? this.proxyState.loading, this.proxyState.isTableEvent = e.isTableEvent ?? this.proxyState.isTableEvent, this.proxyState.selectedRows = e.selectedRows ?? this.proxyState.selectedRows;
+  bindState(t) {
+    this.stateSources.value = t;
   }
 }
 export {
-  $ as TableApi,
-  M as getDefaultState
+  k as TableApi,
+  C as getDefaultState
 };

package/dist/components/tt-table/src/utils/table-form-api.d.ts

@@ -13,37 +13,37 @@ import { Store } from '@tanstack/vue-store';
  * api.reload()
  * api.setFormProps({ ... })
  */
-declare class TableFormApi {
+declare class TableFormApi<Row = any> {
     /** form 表单实例（FormApi） */
     formApi: TtExtendedFormApi;
     /** 表格 API 实例（TableApi） */
-    tableApi: TtTableExtendedTableApi;
+    tableApi: TtTableExtendedTableApi<Row>;
     /** vxe-grid 表格实例 */
     grid: VxeGridInstance;
     /** 当前表单+表格的 props 状态 */
-    state: null | TtTableFormProps;
+    state: null | TtTableFormProps<Row>;
     /** 表单操作方法集合（TableFormActionType） */
-    tableForm: TtTableFormActionType;
+    tableForm: TtTableFormActionType<Row>;
     /** 响应式 store，存储表单+表格的状态 */
-    store: Store<TtTableFormProps>;
+    store: Store<TtTableFormProps<Row>>;
     private isMounted;
     private stateHandler;
     /**
      * 构造函数，初始化 store、tableApi、状态等
      * @param options 表单+表格配置项
      */
-    constructor(options?: TtTableFormProps);
+    constructor(options?: TtTableFormProps<Row>);
     /**
      * 组件挂载时调用，注入表单和表格实例
      * @param instance 表单操作方法实例
      * @param formApi 表单实例
      */
-    mount(instance: null | TtTableFormActionType, formApi: TtExtendedFormApi): void;
+    mount(instance: null | TtTableFormActionType<Row>, formApi: TtExtendedFormApi): void;
     /**
      * 更新表单+表格的数据
      * @param stateOrFn 新状态或返回新状态的函数
      */
-    setState(stateOrFn: ((prev: TtTableFormProps) => Partial<TtTableFormProps>) | Partial<TtTableFormProps>): void;
+    setState(stateOrFn: ((prev: TtTableFormProps<Row>) => Partial<TtTableFormProps<Row>>) | Partial<TtTableFormProps<Row>>): void;
     /**
      * 重新加载表格数据
      * @param data 可选的查询参数
@@ -64,12 +64,12 @@ declare class TableFormApi {
     /**
      * 获取表格 API 实例
      */
-    tableInstance(): TtTableExtendedTableApi;
+    tableInstance(): TtTableExtendedTableApi<Row>;
     /**
      * 设置表格属性
      * @param props 表格属性
      */
-    setTableProps(props: Partial<TtTableProps>): void;
+    setTableProps(props: Partial<TtTableProps<Row>>): void;
     /**
      * 设置表单属性
      * @param props 表单属性
@@ -79,7 +79,7 @@ declare class TableFormApi {
      * 设置表单+表格属性
      * @param props 属性
      */
-    setProps(props: Partial<TtTableFormProps>): void;
+    setProps(props: Partial<TtTableFormProps<Row>>): void;
     /**
      * 组件卸载时调用，重置挂载状态
      */