项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

VirtualList 虚拟滚动 ​

万级数据只渲染可视窗口的列表基元,同时支撑 Listy(原 List 组件的替代)与 Select 虚拟化。

两种模式:传 item-size 走固定行高(纯数学定位);不传则动态实测行高(渲染后回填偏移表,滚动中收敛)。

对标 ant-design v6:通用 List 已废弃,由虚拟列表替代。本组件注册了别名 EbListy(标签 <eb-listy>),从旧 List 迁移见 List(已废弃)。

基础用法 ​

#0数据行 1
#1数据行 2
#2数据行 3
#3数据行 4
#4数据行 5
#5数据行 6
#6数据行 7
#7数据行 8
#8数据行 9
#9数据行 10
#10数据行 11

Listy 别名 ​

<eb-listy> 与 <eb-virtual-list> 完全等价(同一组件的两个注册名),方便从旧 List 或 ant-design Listy 迁移:

#0数据行 1
#1数据行 2
#2数据行 3
#3数据行 4
#4数据行 5
#5数据行 6
#6数据行 7
#7数据行 8
#8数据行 9
#9数据行 10
#10数据行 11

VirtualList API ​

Props ​

名称类型默认值说明
itemsArray[]数据源
item-keyString / Function—唯一键字段名或 (item) => key
item-sizeNumber—固定行高(px);不传走动态实测
heightNumber / String280容器高度
bufferNumber5视口外上下各多渲染条数
estimated-sizeNumber40动态模式行高估算值
bottom-thresholdNumber20距底部多少 px 触发 scroll-bottom

事件 ​

名称说明
scroll滚动,参数 scrollTop
scroll-bottom滚近底部触发(无限加载)
range-change可视窗口变化,参数 { start, end }

暴露方法 ​

scrollTo(index, align)(align: start / center)、scrollToTop()、getVisibleRange()