Skip to content

虚拟化列表

中等 约 45 分钟

你将构建什么

一个仅渲染视口可见项的 VirtualList 组件,用滚动位置和固定项高计算窗口。

学习目标

  • 用 ref 和事件跟踪滚动位置
  • 从 scrollTop 计算可见项范围
  • 用绝对定位仅渲染可见项
  • 添加间隔保持滚动高度

前置要求

  • useState 和 useRef
  • CSS 绝对定位
  • 滚动事件处理

步骤

  1. 1

    设置容器

    创建固定高度、overflow-y: auto 的 div。这是滚动容器。用 state 和 onScroll 处理器跟踪其 scrollTop。

    代码
    function VirtualList({ items, itemHeight = 50, height = 400 }) {
      const [scrollTop, setScrollTop] = useState(0);
      return (
        <div
          style={{ height, overflowY: 'auto' }}
          onScroll={e => setScrollTop(e.currentTarget.scrollTop)}
        >
          {/* items go here */}
        </div>
      );
    }

    预期结果

    可滚动容器在滚动时更新 scrollTop。

  2. 2

    计算可见窗口

    从 scrollTop 计算起始索引(floor(scrollTop / itemHeight))和可见项数(ceil(height / itemHeight))。添加 overscan 缓冲。

    代码
    const startIndex = Math.floor(scrollTop / itemHeight);
    const visibleCount = Math.ceil(height / itemHeight) + 3; // overscan
    const endIndex = Math.min(startIndex + visibleCount, items.length);
    const visibleItems = items.slice(startIndex, endIndex);

    预期结果

    visibleItems 仅含当前可见行加小缓冲。

  3. 3

    用绝对定位渲染

    在 position: relative、height = totalHeight 的 div 内渲染可见项。每项 position: absolute,top = index * itemHeight。

  4. 4

    添加总高间隔

    滚动容器需知道完整高度以显示滚动条。将内 div 高度设为 items.length * itemHeight,使滚动条反映所有项。

  5. 5

    用 10,000 项测试

    用 10,000 项渲染 VirtualList 并验证平滑滚动。与普通列表渲染全部 10,000 比较——虚拟化版本应即时。

    代码
    const items = Array.from({ length: 10000 }, (_, i) => `Item ${i}`);
    
    function App() {
      return <VirtualList items={items} itemHeight={50} height={500} />;
    }

    预期结果

    10,000 项平滑滚动;任何时刻仅约 12 个 DOM 节点。

自己动手试试

你学到了什么

你实现了窗口化——react-window 和 react-virtualized 背后的技术。它让你渲染任意大小列表而不降低性能。

相关资源

相关课程

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题