React DnD 排序压力测试:1000 项可拖拽列表的 requestAnimationFrame 优化与虚拟列表兼容实践

原创2026-09-19 11:35:281,831 阅读
文章标签:前端UI组件

React DnD 排序压力测试:1000 项可拖拽列表的 requestAnimationFrame 优化与虚拟列表兼容实践

本文基于 react-dnd 仓库中的官方示例文档 Stress Test,结合其完整源码实现,深入剖析 React DnD 在超长可排序列表场景下的性能策略:如何用 requestAnimationFrame 合并高频状态更新让上千个拖拽项保持流畅、为什么 React DnD 的设计天然适合与虚拟列表配合,以及如何扩展父级放置目标实现列表自动滚动。读完本文,你将掌握构建数千级可拖拽列表的实战方案与优化原理。

示例概览:压力测试想验证什么

在 docsite 的示例体系中,04-sortable 目录下共有三个递进的排序示例:

  • simple:最基础的可排序列表,演示核心拖拽排序闭环;
  • cancel-on-drop-outside:在拖出列表边界时取消排序;
  • stress-test:本次要展开的压力测试示例,回答一个非常实际的问题——React DnD 同一时刻到底能处理多少个可拖拽元素。

官方文档给出的结论很直接:这个示例的列表中有 1000 个可拖拽项;借助「在 requestAnimationFrame 回调里更新状态」之类的优化,React DnD 可以在不卡顿的情况下处理几千个元素;超过这个量级之后,建议改用虚拟列表(如 fixed-data-table 一类的方案)。示例入口组件 SortableStressTest.tsx 的默认导出由 index.ts 提供,源码位置为 packages/examples/src/04-sortable/stress-test/。

数据准备:1000 张卡片的双重索引结构

压力测试的数据生成逻辑位于 Container.tsx 的 buildCardData() 中,核心代码非常精简:

function buildCardData() {
	const cardsById: Record<string, CardItem> = {}
	const cardsByIndex: CardItem[] = []

	for (let i = 0; i < 1000; i += 1) {
		const card = { id: i, text: Faker.name.findName() }
		cardsById[card.id] = card
		cardsByIndex[i] = card
	}

	return {
		cardsById,
		cardsByIndex,
	}
}

这里有两个值得注意的设计点:

  1. 数据规模:循环生成整整 1000 张卡片,每张卡片包含唯一的数字 id 和由 faker 生成的人名 text,用于渲染成列表项文本。
  2. 双重索引:数据同时以 cardsById(以 id 为键的映射)和 cardsByIndex(保持顺序的数组)两种形态保存,这与文档中 CardState 接口的定义一一对应:
export interface CardState {
	cardsById: Record<string, CardItem>
	cardsByIndex: CardItem[]
}

cardsById 用于在拖拽移动时 O(1) 地通过 id 找到卡片;cardsByIndex 用于按顺序渲染列表。这种「映射 + 有序数组」的组合是超长列表场景下兼顾查找速度与渲染顺序的常用手段。

另外,SortableStressTest.tsx 顶部有一段注释说明了 SSR 相关的处理:大数据列表不应在服务端渲染,因此组件先用 useState(false) + useEffect(() => setShouldRender(true), []) 的方式,仅在客户端挂载完成后再渲染 <Container />,避免服务端输出 1000 个节点的巨大 HTML:

export const SortableStressTest: FC = () => {
	// Avoid rendering on server because the big data list is generated
	const [shouldRender, setShouldRender] = useState(false)
	// Won't fire on server.
	useEffect(() => setShouldRender(true), [])
	return <>{shouldRender && <Container />}</>
}

拖拽与排序:useDrag / useDrop 的 hover 重排实现

列表中的每一项都是一个独立的拖拽源 + 放置目标,实现在 Card.tsx 中。该组件用 memo 包裹以减少无关重渲染:

export const Card: FC<CardProps> = memo(function Card({ id, text, moveCard }) {
	const ref = useRef(null)
	const [{ isDragging, handlerId }, connectDrag] = useDrag({
		type: ItemTypes.CARD,
		item: { id },
		collect: (monitor) => {
			const result = {
				handlerId: monitor.getHandlerId(),
				isDragging: monitor.isDragging(),
			}
			return result
		},
	})

	const [, connectDrop] = useDrop({
		accept: ItemTypes.CARD,
		hover({ id: draggedId }: { id: string; type: string }) {
			if (draggedId !== id) {
				moveCard(draggedId, id)
			}
		},
	})

	connectDrag(ref)
	connectDrop(ref)
	const opacity = isDragging ? 0 : 1
	const containerStyle = useMemo(() => ({ ...style, opacity }), [opacity])
	return (
		<div ref={ref} style={containerStyle} data-handler-id={handlerId}>
			{text}
		</div>
	)
})

这套实现的关键点在于:

  • 拖拽源:useDrag 指定 item 类型为 ItemTypes.CARD(其定义为 { CARD: 'card' },见 ItemTypes.ts),item 携带卡片自身的 id;collect 回调收集 handlerId(写入 data-handler-id 属性,供测试与调试定位)和 isDragging(拖拽中卡片透明度降为 0,实现「原位置留白」的视觉效果)。
  • 放置目标:useDrop 的 accept 同样为 ItemTypes.CARD,在 hover 中拿到被拖拽项的 draggedId,只要与当前卡片的 id 不同就调用 moveCard(draggedId, id),触发重排。这种「hover 即重排」是即时反馈的排序交互模式。
  • 性能细节:拖拽时透明度样式 { ...style, opacity } 通过 useMemo 缓存,避免每次渲染都重建对象;整个卡片是 memo 组件,只有当 moveCard 引用或 text 等 props 变化时才会重渲染。

性能关键:用 requestAnimationFrame 合并 setState

真正的性能核心在 Container.tsx 的父组件一侧。当一张卡片 hover 到另一张卡片上时,moveCard 被调用,其内部完成数据变更与渲染调度两个步骤:

private moveCard = (id: string, afterId: string): void => {
	const { cardsById, cardsByIndex } = this.cardState

	const card = cardsById[id] as CardItem
	const afterCard = cardsById[afterId] as CardItem
	const cardIndex = cardsByIndex.indexOf(card)
	const afterIndex = cardsByIndex.indexOf(afterCard)
	this.cardState = update(this.cardState, {
		cardsByIndex: {
			$splice: [
				[cardIndex, 1],
				[afterIndex, 0, card],
			],
		},
	})
	this.scheduleUpdate()
}
  1. 不可变更新:用 immutability-helper 的 $splice 指令把被拖拽的卡片从原位置删除、插入到目标位置,生成新的 cardsByIndex,保持数据不可变,便于 React 正确感知变化。
  2. 延迟渲染:注意这里并没有立刻调用 setState,而是交给 scheduleUpdate() 调度:
private scheduleUpdate() {
	if (!this.requestedFrame) {
		this.requestedFrame = requestAnimationFrame(this.drawFrame)
	}
}

private drawFrame = (): void => {
	this.setState(STATE)
	this.requestedFrame = undefined
}

scheduleUpdate 利用 requestAnimationFrame 把状态更新合并到下一帧统一执行:在拖拽过程中 hover 事件可能一帧内触发多次(鼠标划过多个卡片),但 requestedFrame 标志位保证了每一帧最多调度一次 setState,把 N 次重排合并为一次渲染,这正是官方文档所说「在 requestAnimationFrame 回调内更新状态」的优化手段。同时,组件在卸载时(componentWillUnmount)会 cancelAnimationFrame 取消尚未执行的帧回调,避免卸载后触发 setState 告警。

顺带一提,drawFrame 中 setState(STATE) 的 STATE 是一个空对象 {}——真正的卡片数据存放在实例属性 cardState 中而非 React state,空对象只是用来触发一次重渲染。这是刻意为之的设计:避免深拷贝 1000 张卡片数据进 React state,减少内存与比较开销。从源码结构看,这属于该示例针对超长列表场景的具体取舍,常规小列表示例(如 simple)并不需要这样做。

为什么能与虚拟列表无缝配合

官方文档特别强调了一点:React DnD 之所以能和任意虚拟列表组件配合,是因为它不在 DOM 中保存任何状态。

虚拟列表(virtual list)只渲染视口附近的少量 DOM 节点,节点会随滚动被反复创建与回收。如果拖拽框架把状态(如当前拖拽项、拖拽来源)挂在具体 DOM 节点上,节点回收后状态就会丢失。而 React DnD 的架构恰好相反:从 dnd-core 的源码结构可以确认,拖拽过程中的全部状态——当前拖拽项、客户端偏移量、拖拽操作阶段等——统一保存在 DragDropManagerImpl 管理的内置 store 与对应 reducers 中(参见 DragDropManagerImpl.ts、reducers 目录),而 react-dnd 层的 Hook 与 Connector 只是「无状态的接线层」,把 DOM 节点的 ref 与 manager 中的句柄绑定起来。节点可以被回收重建,句柄与状态依旧有效。

在压力测试场景中,这意味着:当你把 Card 换成虚拟列表的 row 组件时,useDrag / useDrop 的用法可以完全不变,React DnD 不关心列表节点是否常驻 DOM。因此示例采用的 1000 个全量节点渲染,只是用来测试「不加虚拟化时 React DnD 自身的极限」;一旦数据规模超出几千项,把同样的卡片代码嵌入 fixed-data-table 之类的虚拟列表即可继续扩展。

扩展:父级放置目标实现自动滚动

压力测试示例没有实现列表自动滚动,这是有意为之——文档明确给出了自行扩展的指引:添加一个父级放置目标(parent drop target),在其 hover 处理器中,把 component.getBoundingClientRect() 与 monitor.getClientOffset() 进行比较,据此判断拖拽项是否接近列表边缘,进而触发滚动。

具体来说,父级放置目标包裹整个列表容器:

  • component.getBoundingClientRect():来自 React 的 ref 节点(或 DOM API getBoundingClientRect),返回列表容器的视口坐标边界,用于确定「边缘」在哪;
  • monitor.getClientOffset():来自放置目标 monitor(DropTargetMonitor),返回当前拖拽指针的客户端坐标(该方法的实现定义于 DropTargetMonitorImpl.ts,底层数据来自 dnd-core 的 dragOffset reducer)。

当「指针坐标 − 容器上边界」小于某个阈值(如接近顶部)或大于「容器高度 − 阈值」(接近底部)时,调用容器滚动方法让列表自动向上/向下滚动,从而实现在拖拽靠近边缘时列表持续滚动、继续排序的效果。官方文档还提到,欢迎把这一能力贡献回该示例,因此在仓库中它是作为「留给读者的进阶练习」存在的。

如何查看与运行示例

该示例的文档页(path 为 /examples/sortable/stress-test)通过 <view-source> 标签关联源码目录 04-sortable/stress-test,docsite 会据此在示例页面上渲染实时预览与源码跳转。若要在本地查看:

  1. 在仓库根目录安装依赖后,运行 docsite 的示例应用(示例代码位于 packages/examples);
  2. 打开排序类目下的 Stress Test 页面,即可看到 1000 张卡片组成的可排序列表;
  3. 源码可直接阅读 packages/examples/src/04-sortable/stress-test 下的 Container.tsx、Card.tsx、SortableStressTest.tsx、ItemTypes.ts 四个文件。

小结

回顾这个压力测试示例,可以提炼出三条可迁移到真实项目的经验:

  1. 数据与渲染解耦:用「映射 + 有序数组」管理大量列表数据,避免把大数据塞进 React state;
  2. 帧级批处理:高频拖拽事件触发的状态更新,用 requestAnimationFrame 标志位合并到每帧一次,是千级节点仍保持流畅的关键;
  3. 无 DOM 状态架构:React DnD 的状态全部保存在 dnd-core 的 manager/store 中,这让它与虚拟列表天然兼容——千级节点用 rAF 优化,万级节点交给虚拟列表,两者可以平滑衔接。
登录后查看全文
react-dnd