虚拟化列表
中等 约 45 分钟
你将构建什么
一个仅渲染视口可见项的 VirtualList 组件,用滚动位置和固定项高计算窗口。
学习目标
- 用 ref 和事件跟踪滚动位置
- 从 scrollTop 计算可见项范围
- 用绝对定位仅渲染可见项
- 添加间隔保持滚动高度
前置要求
- useState 和 useRef
- CSS 绝对定位
- 滚动事件处理
步骤
- 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
计算可见窗口
从 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
用绝对定位渲染
在 position: relative、height = totalHeight 的 div 内渲染可见项。每项 position: absolute,top = index * itemHeight。
提示
relative 容器有完整滚动高度;absolute 项位于计算位置。
- 4
添加总高间隔
滚动容器需知道完整高度以显示滚动条。将内 div 高度设为 items.length * itemHeight,使滚动条反映所有项。
提示
无此间隔,容器仅滚动可见项而非完整列表。
- 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 节点。
自己动手试试
起始代码
function VirtualList({ items, itemHeight, height }) {
// TODO: track scroll, compute window, render visible
}解决方案代码
function VirtualList({items, h=50, H=400}) { const [st, set] = useState(0); const s = Math.floor(st/h), n = Math.ceil(H/h)+3; return <div style={{height:H, overflowY:'auto'}} onScroll={e=>set(e.currentTarget.scrollTop)}><div style={{height:items.length*h, position:'relative'}}>{items.slice(s, s+n).map((item, i) => <div key={s+i} style={{position:'absolute', top:(s+i)*h, height:h}}>{item}</div>)}</div></div>; }你学到了什么
你实现了窗口化——react-window 和 react-virtualized 背后的技术。它让你渲染任意大小列表而不降低性能。
相关资源
相关课程
- React Hooks
useState 跟踪滚动位置。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。