用于展示大量数据的列表。
指定 itemSize 为固定值设置定高虚拟列表。
指定 itemSize 为函数设置不定高列表,需要自行计算元素的高度。
使用组件暴露的 scrollTo 方法滚动至指定位置。
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| height | 必填,设置容器的高度 | number | - |
| width | 必填,设置容器的宽度 | number | - |
| itemSize | 必填,设置每个项目的高度,可以是固定值或根据索引动态计算的函数 | number | ((index: number) => number) | - |
| itemCount | 必填,设置列表中的项目总数 | number | - |
| overscanCount | 可选,设置预渲染的项目数量,用于优化滚动性能 | number | 2 |
| children | 必填,用于渲染每个项目的组件 | React.FC | - |
| 方法 | 说明 | 类型 |
|---|---|---|
| scrollTo | 将滚动条移动至指定位置 | (scrollTop: number) => void |