Skip to content

虚拟列表 (Virtual List)

VirtualList 组件基于 TanStack Virtual 实现高性能虚拟滚动列表,适用于大数据量场景,支持自定义每一项的渲染。

基本用法

Props(属性)

名称类型默认值说明
countnumber0列表总项数
estimate-sizenumber | (index:number)=>number50预估每项高度/宽度(支持函数)
horizontalbooleanfalse是否为横向滚动
optionsobject{}传递给虚拟化的其他参数

Slots(插槽)

名称说明
item渲染每一项,参数为 { index, style }

Events(事件)

事件名说明回调参数
scrollEnd滚动到末尾时触发
scrollStart滚动到开头时触发
scroll滚动时触发当前可见项的索引数组