VirtualList 设计文档

使用建议

虚拟滚动列表底座（泛型）：仅渲染可视区 + overscan 缓冲区高性能渲染超长列表。fixed 定高 O(1) 区间；dynamic 不定高（itemSize='auto'）用 estimatedItemSize 估算 + ResizeObserver 实测回填高度表，前缀和修正偏移/区间并做滚动偏移补偿。支持 vertical/horizontal（horizontal 仅 fixed 定宽，dynamic 退化为按 estimatedItemSize 的定宽）。scrollTarget='self'（默认）内部容器滚动；'window' 用窗口（document）滚动、容器撑高，适合整页长列表（纵向；horizontal 下退化为 self，fixed/dynamic 均复用窗口几何 windowScrollTop）。提供 scrollToIndex 命令式跳转 API。自身无视觉，行渲染由 renderItem 提供。

Accessibility

ARIA role：list

• 视口 role=list，可见行 role=listitem
• 行带 aria-setsize（总数）与 aria-posinset（1 基序号）
• 滚动监听命令式 + rAF 节流，不读 render 期 DOM 几何
• dynamic 行高用 ResizeObserver 命令式实测，cleanup 时 disconnect
• scrollToIndex 为命令式 DOM 写（scrollTop/scrollLeft），放导出函数，不在 render 期

设计变量

该组件暂无专属设计变量。