@kdcloudjs/table 1.2.2-canary.12 → 1.2.2-canary.13

package/es/table/base/table.js

@@ -28,6 +28,7 @@ import TableHeader from './header';
 import { getRichVisibleRectsStream } from './helpers/getRichVisibleRectsStream';
 import { getFullRenderRange, makeRowHeightManager } from './helpers/rowHeightManager';
 import { TableDOMHelper } from './helpers/TableDOMUtils';
+import { FastScrollManager } from './helpers/FastScrollManager';
 import { HtmlTable } from './html-table';
 import Loading from './loading';
 import { Classes, LOCK_SHADOW_PADDING, StyledArtTableWrapper } from './styles';
@@ -35,6 +36,7 @@ import GlobalStyleComponent from './globalStyleComponent';
 import { addResizeObserver, getScrollbarSize, OVERSCAN_SIZE, shallowEqual, STYLED_REF_PROP, sum, syncScrollLeft, throttledWindowResize$, getTableScrollFooterDOM, getTableScrollHeaderDOM, cssPolifill, swapRTLDirection } from './utils';
 import { console, browserType, isStickyUIDegrade } from '../utils';
 import getTableRenderTemplate from './renderTemplates';
+import { TopBlank, BottomBlank } from './BlankComponent';
 var propsDotEmptyContentDeprecatedWarned = false;
 function warnPropsDotEmptyContentIsDeprecated() {
   if (!propsDotEmptyContentDeprecatedWarned) {
@@ -53,6 +55,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
     _this.artTableWrapperRef = /*#__PURE__*/React.createRef();
     _this.hasScrollY = false;
     _this.offsetY = 0;
+    // Blank组件的引用，用于快速滚动时直接更新
+    _this.topBlankRef = /*#__PURE__*/React.createRef();
+    _this.bottomBlankRef = /*#__PURE__*/React.createRef();
     _this.handleRowMouseEnter = function (e) {
       var nodeList = _this.domHelper.getRowNodeListByEvent(e);
       nodeList && nodeList.forEach(function (node) {
@@ -72,8 +77,7 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
         getRowProps = _this$props.getRowProps,
         primaryKey = _this$props.primaryKey,
         isLoading = _this$props.isLoading,
-        emptyCellHeight = _this$props.emptyCellHeight,
-        footerDataSource = _this$props.footerDataSource;
+        emptyCellHeight = _this$props.emptyCellHeight;
       var tableBodyClassName = cx(Classes.tableBody, Classes.horizontalScrollContainer);
       // 低版本Edge浏览器下也会出现双滚动条，这里设置overflow: 'hidden'，先去掉edge的方向键控制滚动条的功能
       var virtualStyle = browserType.isIE || browserType.isEdge ? {
@@ -123,12 +127,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
         className: Classes.virtual,
         tabIndex: -1,
         style: virtualStyle
-      }, topBlank > 0 && /*#__PURE__*/React.createElement("div", {
-        key: "top-blank",
-        className: cx(Classes.virtualBlank, 'top'),
-        style: {
-          height: topBlank
-        }
+      }, /*#__PURE__*/React.createElement(TopBlank, {
+        ref: _this.topBlankRef,
+        height: topBlank
       }), /*#__PURE__*/React.createElement(HtmlTable, {
         tbodyHtmlTag: "tbody",
         getRowProps: getRowProps,
@@ -141,12 +142,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
           limit: bottomIndex,
           last: dataSource.length - 1
         }
-      }), bottomBlank > 0 && /*#__PURE__*/React.createElement("div", {
-        key: "bottom-blank",
-        className: cx(Classes.virtualBlank, 'bottom'),
-        style: {
-          height: bottomBlank
-        }
+      }), /*#__PURE__*/React.createElement(BottomBlank, {
+        ref: _this.bottomBlankRef,
+        height: bottomBlank
       })));
     };
     _this.state = {
@@ -161,6 +159,26 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       maxRenderHeight: 600,
       maxRenderWidth: 800
     };
+    // 初始化快速滚动管理器
+    var fastScrollCallbacks = {
+      onFastScrollStart: function onFastScrollStart(renderData) {
+        _this.setState({
+          previousRenderData: renderData
+        });
+      },
+      onFastScrollEnd: function onFastScrollEnd(scrollData) {
+        _this.setState({
+          previousRenderData: undefined,
+          offsetY: scrollData.offsetY,
+          maxRenderHeight: scrollData.maxRenderHeight,
+          maxRenderWidth: scrollData.maxRenderWidth
+        });
+      },
+      getCurrentRenderRange: function getCurrentRenderRange(offsetY, maxRenderHeight, dataLength) {
+        return _this.rowHeightManager.getRenderRange(offsetY, maxRenderHeight, dataLength);
+      }
+    };
+    _this.fastScrollManager = new FastScrollManager(fastScrollCallbacks);
     return _this;
   }
   /** @deprecated BaseTable.getDoms() 已经过时，请勿调用 */
@@ -282,7 +300,6 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "syncHorizontalScroll",
     value: function syncHorizontalScroll(x) {
-      var direction = this.props.direction;
       var _x = Math.abs(x);
       this.updateOffsetX(_x);
       var flat = _flatInstanceProperty(this.lastInfo);
@@ -310,11 +327,18 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "getVerticalRenderRange",
     value: function getVerticalRenderRange(useVirtual) {
-      var dataSource = this.props.dataSource;
+      var _this$props4 = this.props,
+        dataSource = _this$props4.dataSource,
+        isLowPerformance = _this$props4.isLowPerformance;
       var _this$state = this.state,
         offsetY = _this$state.offsetY,
-        maxRenderHeight = _this$state.maxRenderHeight;
+        maxRenderHeight = _this$state.maxRenderHeight,
+        previousRenderData = _this$state.previousRenderData;
       var rowCount = dataSource.length;
+      // 只有在启用快速滚动时才使用 FastScrollManager 的判断
+      if (isLowPerformance && this.fastScrollManager.getIsFastScrolling() && (previousRenderData === null || previousRenderData === void 0 ? void 0 : previousRenderData.verticalRenderRange)) {
+        return previousRenderData.verticalRenderRange;
+      }
       if (useVirtual.vertical) {
         return this.rowHeightManager.getRenderRange(offsetY, maxRenderHeight, rowCount);
       } else {
@@ -325,12 +349,12 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
     key: "renderTableFooter",
     value: function renderTableFooter(info) {
       // console.log('render footer')
-      var _this$props4 = this.props,
-        _this$props4$footerDa = _this$props4.footerDataSource,
-        footerDataSource = _this$props4$footerDa === void 0 ? [] : _this$props4$footerDa,
-        getRowProps = _this$props4.getRowProps,
-        primaryKey = _this$props4.primaryKey,
-        stickyBottom = _this$props4.stickyBottom;
+      var _this$props5 = this.props,
+        _this$props5$footerDa = _this$props5.footerDataSource,
+        footerDataSource = _this$props5$footerDa === void 0 ? [] : _this$props5$footerDa,
+        getRowProps = _this$props5.getRowProps,
+        primaryKey = _this$props5.primaryKey,
+        stickyBottom = _this$props5.stickyBottom;
       var stickyRightOffset = this.hasScrollY ? this.getScrollBarWidth() : 0;
       var renderFooter = getTableRenderTemplate('footer');
       if (typeof renderFooter === 'function') {
@@ -392,9 +416,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
     key: "renderStickyScroll",
     value: function renderStickyScroll(info) {
       // console.log('render stickyscroll')
-      var _this$props5 = this.props,
-        hasStickyScroll = _this$props5.hasStickyScroll,
-        stickyBottom = _this$props5.stickyBottom;
+      var _this$props6 = this.props,
+        hasStickyScroll = _this$props6.hasStickyScroll,
+        stickyBottom = _this$props6.stickyBottom;
       var hasScroll = this.state.hasScroll;
       var isScroll = hasStickyScroll && hasScroll;
       var stickyScrollContainerStyle = this.getStickyScrollContainerStyle();
@@ -431,9 +455,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "getStickyScrollContainerStyle",
     value: function getStickyScrollContainerStyle() {
-      var _this$props6 = this.props,
-        hasStickyScroll = _this$props6.hasStickyScroll,
-        stickyScrollHeight = _this$props6.stickyScrollHeight;
+      var _this$props7 = this.props,
+        hasStickyScroll = _this$props7.hasStickyScroll,
+        stickyScrollHeight = _this$props7.stickyScrollHeight;
       var hasScroll = this.state.hasScroll;
       var isScroll = hasStickyScroll && hasScroll;
       var height = stickyScrollHeight === 'auto' ? this.getScrollBarWidth() : stickyScrollHeight;
@@ -451,21 +475,21 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       // console.log('render table')
       var info = calculateRenderInfo(this);
       this.lastInfo = info;
-      var _this$props7 = this.props,
-        dataSource = _this$props7.dataSource,
-        className = _this$props7.className,
-        style = _this$props7.style,
-        hasHeader = _this$props7.hasHeader,
-        useOuterBorder = _this$props7.useOuterBorder,
-        isStickyHead = _this$props7.isStickyHead,
-        isStickyHeader = _this$props7.isStickyHeader,
-        isStickyFooter = _this$props7.isStickyFooter,
-        isLoading = _this$props7.isLoading,
-        getTableProps = _this$props7.getTableProps,
-        footerDataSource = _this$props7.footerDataSource,
-        components = _this$props7.components,
-        bordered = _this$props7.bordered,
-        direction = _this$props7.direction;
+      var _this$props8 = this.props,
+        dataSource = _this$props8.dataSource,
+        className = _this$props8.className,
+        style = _this$props8.style,
+        hasHeader = _this$props8.hasHeader,
+        useOuterBorder = _this$props8.useOuterBorder,
+        isStickyHead = _this$props8.isStickyHead,
+        isStickyHeader = _this$props8.isStickyHeader,
+        isStickyFooter = _this$props8.isStickyFooter,
+        isLoading = _this$props8.isLoading,
+        getTableProps = _this$props8.getTableProps,
+        footerDataSource = _this$props8.footerDataSource,
+        components = _this$props8.components,
+        bordered = _this$props8.bordered,
+        direction = _this$props8.direction;
       info.direction = direction;
       var artTableWrapperClassName = cx(Classes.artTableWrapper, (_cx = {
         'use-outer-border': useOuterBorder,
@@ -506,10 +530,10 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       this.initSubscriptions();
       this.didMountOrUpdate();
       // console.log('did mount end')
-      var _this$props8 = this.props,
-        cssVariables = _this$props8.cssVariables,
-        enableCSSVariables = _this$props8.enableCSSVariables,
-        bordered = _this$props8.bordered;
+      var _this$props9 = this.props,
+        cssVariables = _this$props9.cssVariables,
+        enableCSSVariables = _this$props9.enableCSSVariables,
+        bordered = _this$props9.bordered;
       cssPolifill({
         variables: cssVariables || {},
         enableCSSVariables: enableCSSVariables,
@@ -524,10 +548,10 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
     value: function componentDidUpdate(prevProps, prevState) {
       var _a;
       // console.log('did update start')
-      var _this$props9 = this.props,
-        cssVariables = _this$props9.cssVariables,
-        enableCSSVariables = _this$props9.enableCSSVariables,
-        bordered = _this$props9.bordered;
+      var _this$props10 = this.props,
+        cssVariables = _this$props10.cssVariables,
+        enableCSSVariables = _this$props10.enableCSSVariables,
+        bordered = _this$props10.bordered;
       if (!shallowEqual(prevProps === null || prevProps === void 0 ? void 0 : prevProps.cssVariables, (_a = this.props) === null || _a === void 0 ? void 0 : _a.cssVariables)) {
         cssPolifill({
           variables: cssVariables || {},
@@ -543,10 +567,13 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "didMountOrUpdate",
     value: function didMountOrUpdate(prevProps, prevState) {
-      this.syncHorizontalScrollFromTableBody();
-      this.updateStickyScroll();
-      this.adjustNeedRenderLock();
-      this.updateRowHeightManager();
+      var _this2 = this;
+      window.requestAnimationFrame(function () {
+        _this2.syncHorizontalScrollFromTableBody();
+        _this2.updateStickyScroll();
+        _this2.adjustNeedRenderLock();
+        _this2.updateRowHeightManager();
+      });
       this.updateScrollLeftWhenLayoutChanged(prevProps, prevState);
     }
   }, {
@@ -568,25 +595,25 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
   }, {
     key: "initSubscriptions",
     value: function initSubscriptions() {
-      var _this2 = this;
+      var _this3 = this;
       var _this$domHelper2 = this.domHelper,
         virtual = _this$domHelper2.virtual,
         stickyScroll = _this$domHelper2.stickyScroll;
       this.rootSubscription.add(throttledWindowResize$.subscribe(function () {
-        _this2.updateStickyScroll();
-        _this2.adjustNeedRenderLock();
+        _this3.updateStickyScroll();
+        _this3.adjustNeedRenderLock();
       }));
       this.resizeSubject.pipe(op.debounceTime(100)).subscribe(function () {
         var _a, _b;
-        (_b = (_a = _this2.props).setTableWidth) === null || _b === void 0 ? void 0 : _b.call(_a, _this2.domHelper.tableBody.clientWidth);
+        (_b = (_a = _this3.props).setTableWidth) === null || _b === void 0 ? void 0 : _b.call(_a, _this3.domHelper.tableBody.clientWidth);
       });
       var handleTableWrapperResize = function handleTableWrapperResize() {
-        _this2.resizeSubject.next();
+        _this3.resizeSubject.next();
       };
       this.resizeObserver = addResizeObserver(this.domHelper.artTableWrapper, handleTableWrapperResize);
       // 滚动同步
       this.rootSubscription.add(syncScrollLeft([getTableScrollHeaderDOM(this.domHelper), virtual, getTableScrollFooterDOM(this.domHelper), stickyScroll], function (scrollLeft) {
-        _this2.syncHorizontalScroll(scrollLeft);
+        _this3.syncHorizontalScroll(scrollLeft);
       }));
       var richVisibleRects$ = getRichVisibleRectsStream(this.domHelper.virtual, this.props$.pipe(op.skip(1), op.mapTo('structure-may-change')), this.props.virtualDebugLabel).pipe(op.shareReplay());
       // 每当可见部分发生变化的时候，调整 loading icon 的未知（如果 loading icon 存在的话）
@@ -600,7 +627,7 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       }))]).subscribe(function (_ref3) {
         var _ref4 = _slicedToArray(_ref3, 1),
           clipRect = _ref4[0];
-        var loadingIndicator = _this2.domHelper.getLoadingIndicator();
+        var loadingIndicator = _this3.domHelper.getLoadingIndicator();
         if (!loadingIndicator) {
           return;
         }
@@ -611,9 +638,9 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       }));
       // 每当可见部分发生变化的时候，如果开启了虚拟滚动，则重新触发 render
       this.rootSubscription.add(richVisibleRects$.pipe(op.filter(function () {
-        var _this2$lastInfo$useVi = _this2.lastInfo.useVirtual,
-          horizontal = _this2$lastInfo$useVi.horizontal,
-          vertical = _this2$lastInfo$useVi.vertical;
+        var _this3$lastInfo$useVi = _this3.lastInfo.useVirtual,
+          horizontal = _this3$lastInfo$useVi.horizontal,
+          vertical = _this3$lastInfo$useVi.vertical;
         return horizontal || vertical;
       }), op.map(function (_ref5) {
         var clipRect = _ref5.clipRect,
@@ -630,8 +657,29 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
         }
         // 因为 overscan 的存在，滚动较小的距离时不需要触发组件重渲染
         return Math.abs(x.maxRenderWidth - y.maxRenderWidth) < OVERSCAN_SIZE / 2 && Math.abs(x.maxRenderHeight - y.maxRenderHeight) < OVERSCAN_SIZE / 2 && Math.abs(x.offsetY - y.offsetY) < OVERSCAN_SIZE / 2;
+      }),
+      // 快速滚动检测和处理
+      op.tap(function (sizeAndOffset) {
+        // 只有在启用快速滚动时才使用 FastScrollManager 处理滚动事件
+        if (_this3.props.isLowPerformance) {
+          _this3.fastScrollManager.handleScrollEvent(sizeAndOffset, {
+            offsetY: _this3.state.offsetY,
+            maxRenderHeight: _this3.state.maxRenderHeight,
+            maxRenderWidth: _this3.state.maxRenderWidth
+          }, _this3.props.dataSource.length, _this3.domHelper.virtual.scrollHeight);
+        }
       })).subscribe(function (sizeAndOffset) {
-        _this2.setState(sizeAndOffset);
+        var _a, _b;
+        // 正常滚动时也需要实时更新 blank 高度，确保缓慢滚动时的视觉连续性
+        var currentRange = _this3.rowHeightManager.getRenderRange(sizeAndOffset.offsetY, sizeAndOffset.maxRenderHeight, _this3.props.dataSource.length);
+        // 直接更新 DOM，避免等待下次渲染
+        (_a = _this3.topBlankRef.current) === null || _a === void 0 ? void 0 : _a.updateHeight(currentRange.topBlank);
+        (_b = _this3.bottomBlankRef.current) === null || _b === void 0 ? void 0 : _b.updateHeight(currentRange.bottomBlank);
+        // 只有在启用快速滚动时才检查快速滚动状态
+        if (_this3.props.isLowPerformance && _this3.fastScrollManager.getIsFastScrolling()) {
+          return;
+        }
+        _this3.setState(sizeAndOffset);
       }));
       this.rootSubscription.add(richVisibleRects$.pipe(op.map(function (_ref6) {
         var clipRect = _ref6.clipRect,
@@ -649,13 +697,13 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
         var _a;
         var offsetY = sizeAndOffset.offsetY,
           maxRenderHeight = sizeAndOffset.maxRenderHeight;
-        var scrollDirection = offsetY - _this2.offsetY >= 0 ? 'down' : 'up';
-        _this2.offsetY = offsetY;
-        var rowCount = _this2.props.dataSource.length;
-        var vertical = _this2.rowHeightManager.getRenderRange(offsetY, maxRenderHeight, rowCount);
+        var scrollDirection = offsetY - _this3.offsetY >= 0 ? 'down' : 'up';
+        _this3.offsetY = offsetY;
+        var rowCount = _this3.props.dataSource.length;
+        var vertical = _this3.rowHeightManager.getRenderRange(offsetY, maxRenderHeight, rowCount);
         var topIndex = vertical.topIndex,
           bottomIndex = vertical.bottomIndex;
-        var blockSize = ((_a = _this2.props.scrollLoad) === null || _a === void 0 ? void 0 : _a.blockSize) || 200;
+        var blockSize = ((_a = _this3.props.scrollLoad) === null || _a === void 0 ? void 0 : _a.blockSize) || 200;
         var topBlockStartIndex = Math.floor(Math.max(topIndex - 1, 0) / blockSize) * blockSize;
         var bottomBlockStartIndex = Math.floor((bottomIndex + 1) / blockSize) * blockSize;
         return scrollDirection === 'down' ? [topBlockStartIndex, bottomBlockStartIndex] : [bottomBlockStartIndex, topBlockStartIndex];
@@ -670,7 +718,7 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       // 过滤掉重复掉值
       op.distinctUntilChanged()).subscribe(function (startIndex) {
         var _a;
-        (_a = _this2.props.scrollLoad) === null || _a === void 0 ? void 0 : _a.callback(startIndex);
+        (_a = _this3.props.scrollLoad) === null || _a === void 0 ? void 0 : _a.callback(startIndex);
       }));
     }
   }, {
@@ -680,6 +728,10 @@ export var BaseTable = /*#__PURE__*/function (_React$Component) {
       (_a = this.resizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
       this.rootSubscription.unsubscribe();
       this.resizeSubject.unsubscribe();
+      // 只有在启用快速滚动时才清理快速滚动管理器
+      if (this.props.isLowPerformance) {
+        this.fastScrollManager.cleanup();
+      }
     }
     /** 更新 DOM 节点的引用，方便其他方法直接操作 DOM */
   }, {
@@ -774,6 +826,7 @@ BaseTable.defaultProps = {
   stickyScrollHeight: 'auto',
   useVirtual: 'auto',
   estimatedRowHeight: 48,
+  isLowPerformance: false,
   isLoading: false,
   components: {},
   getTableProps: noop,

package/lib/table/base/BlankComponent.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface BlankProps {
+    height: number;
+    className?: string;
+}
+export interface BlankRef {
+    updateHeight: (newHeight: number) => void;
+}
+export declare const TopBlank: React.MemoExoticComponent<React.ForwardRefExoticComponent<BlankProps & React.RefAttributes<BlankRef>>>;
+export declare const BottomBlank: React.MemoExoticComponent<React.ForwardRefExoticComponent<BlankProps & React.RefAttributes<BlankRef>>>;
+export {};

package/lib/table/base/BlankComponent.js

@@ -0,0 +1,75 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TopBlank = exports.BottomBlank = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/slicedToArray"));
+var _react = _interopRequireWildcard(require("react"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _styles = require("./styles");
+function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+var TopBlankComponent = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
+  var initialHeight = _ref.height;
+  var _useState = (0, _react.useState)(initialHeight),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    height = _useState2[0],
+    setHeight = _useState2[1];
+  (0, _react.useImperativeHandle)(ref, function () {
+    return {
+      updateHeight: function updateHeight(newHeight) {
+        if (height !== newHeight) {
+          setHeight(newHeight);
+        }
+      }
+    };
+  }, [height]);
+  return /*#__PURE__*/_react.default.createElement("div", {
+    style: {
+      height: height
+    }
+  });
+});
+TopBlankComponent.displayName = 'TopBlank';
+var BottomBlankComponent = /*#__PURE__*/(0, _react.forwardRef)(function (_ref2, ref) {
+  var initialHeight = _ref2.height,
+    className = _ref2.className;
+  var _useState3 = (0, _react.useState)(initialHeight),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    height = _useState4[0],
+    setHeight = _useState4[1];
+  (0, _react.useImperativeHandle)(ref, function () {
+    return {
+      updateHeight: function updateHeight(newHeight) {
+        if (height !== newHeight) {
+          setHeight(newHeight);
+        }
+      }
+    };
+  }, [height]);
+  if (height <= 0) {
+    return null;
+  }
+  return /*#__PURE__*/_react.default.createElement("div", {
+    key: "bottom-blank",
+    className: (0, _classnames.default)(_styles.Classes.virtualBlank, 'bottom', className),
+    style: {
+      height: height
+    }
+  });
+});
+BottomBlankComponent.displayName = 'BottomBlank';
+// 使用 memo 优化，只有当 height 或 className 改变时才重新渲染
+var TopBlank = /*#__PURE__*/(0, _react.memo)(TopBlankComponent, function (prevProps, nextProps) {
+  return prevProps.height === nextProps.height && prevProps.className === nextProps.className;
+});
+exports.TopBlank = TopBlank;
+var BottomBlank = /*#__PURE__*/(0, _react.memo)(BottomBlankComponent, function (prevProps, nextProps) {
+  return prevProps.height === nextProps.height && prevProps.className === nextProps.className;
+});
+exports.BottomBlank = BottomBlank;

package/lib/table/base/helpers/FastScrollManager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 快速滚动管理器
+ * 抽取 BaseTable 中的快速滚动相关逻辑
+ */
+export interface FastScrollConfig {
+    /** 预渲染缓冲区大小，用于快速滚动判断 */
+    overscanSize?: number;
+    /** 快速滚动速度阈值 (像素/毫秒) */
+    velocityThreshold?: number;
+    /** 快速滚动距离倍数阈值 */
+    distanceMultiplier?: number;
+    /** 快速滚动结束等待时间 (毫秒) - 高速滚动 */
+    fastScrollEndDelayHigh?: number;
+    /** 快速滚动结束等待时间 (毫秒) - 普通滚动 */
+    fastScrollEndDelayNormal?: number;
+    /** 高速滚动速度阈值 (像素/毫秒) */
+    highVelocityThreshold?: number;
+}
+export interface FastScrollState {
+    lastScrollTime: number;
+    scrollVelocity: number;
+    lastOffsetY: number;
+}
+export interface ScrollEventData {
+    offsetY: number;
+    maxRenderHeight: number;
+    maxRenderWidth: number;
+}
+export interface VerticalRenderRange {
+    topIndex: number;
+    bottomIndex: number;
+    topBlank: number;
+    bottomBlank: number;
+}
+export interface FastScrollCallbacks {
+    onFastScrollStart: (renderData: {
+        offsetY: number;
+        maxRenderHeight: number;
+        maxRenderWidth: number;
+        verticalRenderRange: VerticalRenderRange;
+    }) => void;
+    onFastScrollEnd: (scrollData: ScrollEventData) => void;
+    getCurrentRenderRange: (offsetY: number, maxRenderHeight: number, dataLength: number) => VerticalRenderRange;
+}
+export declare class FastScrollManager {
+    private state;
+    private isFastScrolling;
+    private fastScrollEndTimer?;
+    private config;
+    private callbacks;
+    constructor(callbacks: FastScrollCallbacks, config?: FastScrollConfig);
+    /**
+     * 检测是否接近底部（剩余滚动距离少于两屏）
+     */
+    private isNearBottom;
+    /**
+     * 处理滚动事件 - 检测和处理快速滚动
+     */
+    handleScrollEvent(sizeAndOffset: ScrollEventData, currentState: {
+        offsetY: number;
+        maxRenderHeight: number;
+        maxRenderWidth: number;
+    }, dataLength: number, totalScrollHeight: number): void;
+    /**
+     * 开始快速滚动
+     */
+    private startFastScrolling;
+    /**
+     * 重置快速滚动结束定时器
+     */
+    private resetFastScrollEndTimer;
+    /**
+     * 结束快速滚动
+     */
+    private endFastScrolling;
+    /**
+     * 清理资源
+     */
+    cleanup(): void;
+    /**
+     * 获取当前是否处于快速滚动状态
+     */
+    getIsFastScrolling(): boolean;
+    /**
+     * 获取当前滚动速度
+     */
+    getScrollVelocity(): number;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): Readonly<Required<FastScrollConfig>>;
+}