VariableSizeList:动态行高
使用 VariableSizeList 和 itemSize 回调模式,处理高度不同的项目。
VariableSizeList:动态行高 是 CoddyKit 上的免费 React Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 React Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 React Academy 课程共包含 4 节课。
项目具有不同高度时
有时各行并不统一:聊天列表中既有简短消息,也有较长消息;信息流中的卡片也可能包含不同数量的内容。FixedSizeList 无法处理这种情况,因为它假设所有项目都使用同一个固定的 itemSize。
对于这些情况,react-window 提供了一种列表类型,允许每个项目声明自己的尺寸。
用 VariableSizeList 替代 FixedSizeList
VariableSizeList 的工作方式与 FixedSizeList 类似,但它接受每个项目各自的尺寸。您只需改为导入它,并提供一个返回指定索引对应尺寸的函数。
其他部分,包括子元素渲染函数和关键的样式属性,都保持不变,因此迁移工作很少。
作为函数的 itemSize
使用 VariableSizeList 时,itemSize 是一个接收索引并返回该行像素高度的函数。react-window 会调用它来计算偏移量并确定可见窗口。
这样您就可以编码已知的高度,例如为包含图片的项目设置更高的行,为纯文本项目设置更矮的行。
预先计算与测量
如果您提前知道每行的高度,可以直接从 itemSize 函数返回该高度。如果高度取决于渲染后的内容,则必须在行绘制完成后进行测量。
预先计算的高度最简单、最快;测量得到的高度更加灵活,但需要额外处理,才能将尺寸反馈给列表。
测量后调用 resetAfterIndex
VariableSizeList 会缓存项目偏移量以提升性能。当测量得到的高度发生变化时,您必须通过列表的引用调用 resetAfterIndex 方法,使其从该索引开始重新计算后续位置。
忘记执行这一步会留下过时的偏移量并导致各行错位,因此 resetAfterIndex 是实现动态测量的关键。
高度的两难问题
这里存在一个先有鸡还是先有蛋的问题:您需要高度才能渲染行,但只有在行渲染完成后才能知道真实高度。列表必须先放置行,之后才能测量它。
解决方法是先使用估算值进行渲染,知道真实高度后再进行修正。
估算、渲染、测量、更新
标准模式是先使用估算高度渲染各行,在绘制完成后通过引用或 ResizeObserver 测量实际高度,保存测量值,然后调用 resetAfterIndex 更新位置。
这一循环会很快收敛,因此列表在第一次测量完成后就能稳定到正确的偏移量。
getItemSize 必须保持稳定
itemSize 函数在多次渲染之间应保持稳定,通常可以使用 useCallback 包装,这样列表就不会不断使缓存的偏移量失效。
在行内直接定义的不稳定函数可能会强制进行不必要的重新计算,损害虚拟化本应提供的性能。
性能权衡
VariableSizeList 比 FixedSizeList 执行更多工作,因为它无法假定偏移量恒定,还必须跟踪每个项的大小。测量高度时,额外的测量也会增加开销。
对于行高确实不同的列表,这项开销是值得的;对于高度统一的行,FixedSizeList 仍然是更快、更简单的选择。
回退到固定大小并进行近似
如果精确的动态测量成本过高,有时可以采用近似方法。将行按高度分成几个固定类别,或使用合理的平均值,可以让您继续使用 FixedSizeList。
这样会用布局的简洁性和速度换取像素级精确度;当少量偏移误差可以接受时,这是一种合理的折中方案。
快速检查:VariableSizeList 的 itemSize
回想一下 VariableSizeList 如何获取每行的高度。
回顾:VariableSizeList
VariableSizeList 通过将 itemSize 设置为接收索引的函数来处理高度不同的行。高度可以预先计算,也可以进行测量;测量得到的高度需要经过“估算—渲染—测量—更新”循环,并调用 resetAfterIndex。
请使用 useCallback 保持 itemSize 函数稳定。它的开销高于 FixedSizeList,因此对于高度统一的行,或近似已经足够的情况,请优先选择固定大小的变体。
常见问题解答
「VariableSizeList:动态行高」课时是免费的吗?
是的 — 「VariableSizeList:动态行高」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 React Academy 课程的其余内容,请升级到 CoddyKit PRO。 React Academy 课程共包含 4 节课。
「VariableSizeList:动态行高」这节课中我会学到什么?
使用 VariableSizeList 和 itemSize 回调模式,处理高度不同的项目。 你通过在浏览器中直接运行的动手代码来练习 React Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 React Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 React Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。
「VariableSizeList:动态行高」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 React Academy 课中编写并运行代码吗?
能。每节 React Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 大型列表渲染问题
- FixedSizeList:渲染数千个项目
- VariableSizeList:动态行高
- 结合虚拟化与数据获取