0Pricing
React Academy · 课时

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 反馈 — 无需本地设置。

此课程中的所有课时

  1. 大型列表渲染问题
  2. FixedSizeList:渲染数千个项目
  3. VariableSizeList:动态行高
  4. 结合虚拟化与数据获取
← 返回 React Academy