zmdms-webui 2.4.3 → 2.4.5

package/dist/es/canvastable/canvasTable.js

@@ -1,6 +1,6 @@
 import { __assign } from '../_virtual/_tslib.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { useRef, useState, useCallback, useMemo, useImperativeHandle } from 'react';
+import { useRef, useState, useCallback, useMemo, useEffect, useImperativeHandle } from 'react';
 import { Spin } from 'antd';
 import './components/FilterPopover.js';
 import CellOverlay from './components/CellOverlay.js';
@@ -161,6 +161,14 @@ function CanvasTable(props) {
         maxScrollLeft: maxScrollLeft,
         onScroll: onScroll,
     }), scrollState = _1.scrollState, setScrollState = _1.setScrollState;
+    // 使用 ref 保存最新的滚动位置，确保在组件卸载过程中仍能访问
+    var scrollPositionRef = useRef({ x: 0, y: 0 });
+    useEffect(function () {
+        scrollPositionRef.current = {
+            x: scrollState.scrollLeft,
+            y: scrollState.scrollTop,
+        };
+    }, [scrollState.scrollLeft, scrollState.scrollTop]);
     // 数据变化时重置滚动位置（筛选、排序、数据源更新等操作后）
     useScrollReset({
         dataSourceLength: dataSource.length,
@@ -249,21 +257,19 @@ function CanvasTable(props) {
         onColumnResize: handleColumnResize,
     }), resizeState = _3.resizeState, checkResizeHandle = _3.checkResizeHandle, startResize = _3.startResize, updateResize = _3.updateResize, endResize = _3.endResize, setHoverResizeColumn = _3.setHoverResizeColumn, getColumnWidth = _3.getColumnWidth, RESIZE_HANDLE_WIDTH = _3.RESIZE_HANDLE_WIDTH;
     // 复制到剪贴板
-    var getSelectedCellsText = useCopyToClipboard({
+    var _4 = useCopyToClipboard({
         cellSelection: state.cellSelection,
         processedDataSource: finalDataSource,
         columns: processedColumns,
         containerRef: containerRef,
-    }).getSelectedCellsText;
+    }), getSelectedCellsText = _4.getSelectedCellsText, copyToClipboard = _4.copyToClipboard;
     // 处理右键菜单的复制操作
     var handleCopy = useCallback(function () {
         var text = getSelectedCellsText();
-        if (text && navigator.clipboard) {
-            navigator.clipboard.writeText(text).catch(function (err) {
-                console.error("Failed to copy:", err);
-            });
+        if (text) {
+            copyToClipboard(text);
         }
-    }, [getSelectedCellsText]);
+    }, [getSelectedCellsText, copyToClipboard]);
     // 过滤勾选框和index行给导出用
     var exportColumns = useMemo(function () {
         return processedColumns.filter(function (item) { return !item.key.includes("__"); });
@@ -272,10 +278,10 @@ function CanvasTable(props) {
     var exportExcel = useExcelExport(newDataSource, {
         columns: exportColumns,
         isAutoMerge: isAutoMerge,
-        summaryConfig: [],
+        summaryConfig: (exportExcelConfig === null || exportExcelConfig === void 0 ? void 0 : exportExcelConfig.isExportNoSummary) ? undefined : [],
     });
     // 交互事件处理（使用baseScrollbarMetrics的maxScrollTop/maxScrollLeft以保持稳定）
-    var _4 = useTableInteraction({
+    var _5 = useTableInteraction({
         state: state,
         setState: setState,
         scrollState: scrollState,
@@ -322,7 +328,7 @@ function CanvasTable(props) {
         fixedRowsCount: fixedRowsCount,
         fixedRowsConfig: fixedRowsConfig,
         summaryFixed: summaryFixed,
-    }), handleCanvasMouseDown = _4.handleCanvasMouseDown, handleCanvasMouseMove = _4.handleCanvasMouseMove, handleCanvasMouseUp = _4.handleCanvasMouseUp, handleCanvasMouseLeave = _4.handleCanvasMouseLeave, handleCanvasContextMenu = _4.handleCanvasContextMenu;
+    }), handleCanvasMouseDown = _5.handleCanvasMouseDown, handleCanvasMouseMove = _5.handleCanvasMouseMove, handleCanvasMouseUp = _5.handleCanvasMouseUp, handleCanvasMouseLeave = _5.handleCanvasMouseLeave, handleCanvasContextMenu = _5.handleCanvasContextMenu;
     // 渲染表格
     useTableRender(__assign(__assign({ canvasRef: canvasRef, processedDataSource: finalDataSource, columnRenderInfos: columnRenderInfos, columns: processedColumns, // 传递原始columns用于渲染多级表头
         state: state, scrollState: scrollState, rowSelection: rowSelection, containerWidth: containerWidth, containerHeight: containerHeight, headerHeight: calculatedHeaderHeight, baseHeaderHeight: headerHeight, // 传入原始基础高度用于计算每层高度
@@ -421,6 +427,14 @@ function CanvasTable(props) {
         scrollTo: function (params) {
             setScrollState(function (prev) { return (__assign(__assign({}, prev), { scrollLeft: params.x !== undefined ? params.x : prev.scrollLeft, scrollTop: params.y !== undefined ? params.y : prev.scrollTop })); });
         },
+        /** 获取滚动条位置信息 */
+        getScrollPosition: function () {
+            // 返回 ref 中的值，确保在组件卸载过程中仍能获取到最后的滚动位置
+            return {
+                x: scrollPositionRef.current.x,
+                y: scrollPositionRef.current.y,
+            };
+        },
         /** 获取当前排序状态 */
         getSortState: function () {
             return {

package/dist/es/canvastable/interface.d.ts

@@ -173,6 +173,10 @@ interface ICanvasColumnType<RecordType = any> {
      * 是否加上千分符
      */
     thousand?: boolean;
+    /**
+     * 空值时显示的文本，默认为 "—"
+     */
+    emptyText?: string;
     /**
      * 设置单元格属性（用于合并单元格等）
      * 参考 antd table 的 onCell 用法
@@ -405,7 +409,7 @@ interface ICanvasTableProps<RecordType = any> {
     /**
      * 表格ref句柄，用于暴露表格的一些方法
      */
-    tableRefHandle?: React__default.Ref<ICanvasTableRefHandle | undefined>;
+    tableRefHandle?: React__default.MutableRefObject<ICanvasTableRefHandle | undefined>;
     /**
      * 导出excel的一些配置
      */
@@ -414,6 +418,7 @@ interface ICanvasTableProps<RecordType = any> {
         time?: string;
         topDescriptionRowHeight?: number;
         fileName: string;
+        isExportNoSummary?: boolean;
     };
 }
 /**
@@ -463,6 +468,16 @@ interface ICanvasTableRefHandle {
         x?: number;
         y?: number;
     }) => void;
+    /**
+     * 获取滚动条位置信息
+     * @returns 包含 x(水平) 和 y(垂直) 滚动位置的对象
+     */
+    getScrollPosition: () => {
+        /** 水平滚动位置 */
+        x: number;
+        /** 垂直滚动位置 */
+        y: number;
+    };
     /**
      * 获取当前排序状态
      */

package/dist/es/canvastable/utils/formatHelpers.js

@@ -18,8 +18,10 @@ var formatDate = function (value, format) {
  * 格式化单元格值
  */
 var formatCellValue = function (value, column) {
-    if (value === null || value === undefined)
-        return "";
+    // 空值处理：null、undefined、空字符串
+    if (value === null || value === undefined || value === "") {
+        return column.emptyText !== undefined ? column.emptyText : "— —";
+    }
     var formattedValue = value;
     // 日期格式化
     if (column.dateFormat) {

package/dist/es/table/interface.d.ts

@@ -245,6 +245,10 @@ interface IColumnType<RecordType> extends Omit<ColumnType<RecordType>, "render">
     dateFormat?: string;
     precision?: number;
     thousand?: boolean;
+    /**
+     * 空值时显示的文本，默认为 "—"
+     */
+    emptyText?: string;
 }
 interface IRenderOptions {
     insertTableFromClipboard: IFuncInsertTableFromClipboard;
@@ -305,6 +309,16 @@ interface ITableRefHandel {
         vid?: string;
         index?: number;
     }) => void;
+    /**
+     * 获取滚动条位置信息
+     * @returns 包含 x(水平) 和 y(垂直) 滚动位置的对象
+     */
+    getScrollPosition?: () => {
+        /** 水平滚动位置 */
+        x: number;
+        /** 垂直滚动位置 */
+        y: number;
+    };
     /**
      * 重置
      */

package/dist/es/table/table.js

@@ -193,6 +193,8 @@ var Table = function (props) {
     });
     // 表格验证
     var _y = useTableValidate(), tableRef = _y.tableRef, getCurrentTable = _y.getCurrentTable, clearErrorClass = _y.clearErrorClass;
+    // 使用 ref 缓存最新的滚动位置，确保在组件卸载过程中仍能访问
+    var scrollPositionRef = useRef({ x: 0, y: 0 });
     // 滚动条控制方法
     var scrollToPosition = useMemoizedFn(function (options) {
         var _a;
@@ -230,6 +232,24 @@ var Table = function (props) {
             }
         }
     });
+    // 获取滚动条位置
+    var getScrollPosition = useMemoizedFn(function () {
+        var _a;
+        var tableBody = (_a = tableRef.current) === null || _a === void 0 ? void 0 : _a.querySelector(".ant-table-body");
+        if (tableBody) {
+            // 更新 ref 缓存
+            scrollPositionRef.current = {
+                x: tableBody.scrollLeft,
+                y: tableBody.scrollTop,
+            };
+            return scrollPositionRef.current;
+        }
+        // 如果 DOM 已销毁，返回最后缓存的位置
+        return {
+            x: scrollPositionRef.current.x,
+            y: scrollPositionRef.current.y,
+        };
+    });
     // 虚拟滚动选项
     var vComponents = useMemo(function () {
         if (virtualKey) {
@@ -352,6 +372,13 @@ var Table = function (props) {
             scrollTo: function (options) {
                 scrollToPosition(options);
             },
+            /**
+             * 获取滚动条位置信息
+             * @returns 包含滚动位置和容器尺寸的对象
+             */
+            getScrollPosition: function () {
+                return getScrollPosition();
+            },
             /** 动态列配置重置 */
             onResetDynamicList: function () {
                 var _a, _b;

package/dist/es/table/useColumns.js

@@ -324,8 +324,10 @@ function useColumns(columns, options) {
             if (typeof text === "object") {
                 return PLACEHOLDER_NULL;
             }
-            if (text == null || text === "")
-                return PLACEHOLDER_NULL;
+            // 空值处理：null、undefined、空字符串
+            if (text == null || text === "") {
+                return _column.emptyText !== undefined ? _column.emptyText : "—";
+            }
             if (_column.dateFormat)
                 return dayjs(text).format(_column.dateFormat);
             if (_column.precision)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zmdms-webui",
-  "version": "2.4.3",
+  "version": "2.4.5",
   "private": false,
   "main": "dist/index.es.js",
   "module": "dist/index.es.js",