Vue 3分组列表虚拟化渲染需解决分组头高度不固定、组内项数量动态、组间边界对齐三大难点,核心是构建分组索引与全局线性索引的双向映射,结合占位块撑高+绝对定位+动态测量分组头高度+定高子项实现高效精准渲染。

Vue 3 中实现分组列表的虚拟化渲染,核心难点在于:**分组头高度不固定、组内项数量动态、组间边界需精准对齐**。直接套用定高虚拟列表方案会出错——因为所有计算都依赖“每行等高”这一前提,而分组列表天然打破该假设。
关键思路:分组感知的双层索引映射
不能只按“数据项序号”算可见范围,必须建立“逻辑位置 → 实际渲染偏移”的双向映射:
- 第一层是分组索引(Group ID),记录每个分组的起始位置、标题高度、子项数量
- 第二层是全局线性索引(Flat Index),把所有分组头 + 所有子项摊平成一维序列,用于滚动计算和 DOM 定位
- 滚动时,先根据
scrollTop算出当前落在哪个 Flat Index 范围,再反查它属于哪个分组、是否为分组头、或属于哪条子项
结构设计:用占位块撑开总高度,用绝对定位渲染可见内容
避免频繁修改 DOM 结构导致回流,推荐采用 Absolute 定位法:
- 容器设
position: relative; overflow-y: auto - 内部一个
<div class="placeholder">,高度 = 所有分组头高度之和 + 所有子项高度之和(可预估或异步测量) <li>真实渲染区域用 <code>position: absolute; top: 0; left: 0; width: 100%,通过transform: translateY(Y)控制可视部分起始位置 - 每个渲染项(含分组头、子项)都带
style="top: Xpx"或统一用transform偏移,确保位置精确 -
首次加载时延迟测量:用
ref拿到分组头 DOM,调用getBoundingClientRect().height,缓存进分组元数据 - 后续滚动复用缓存值,仅当分组数据更新且标题内容变化时重新测量(加防抖)
- 子项保持定高(如 48px),大幅简化 visibleCount 和 startIndex 计算逻辑
- 总高度
totalHeight= Σ(各分组头高度) + (子项总数 × itemHeight) - 若该项是
type: 'group',渲染分组头组件(传入 group info) - 若该项是
type: 'item',渲染普通子项(传入 item + 所属 group context) - 使用
<slot></slot>或v-for+v-if分支控制,避免无意义节点 - 为防快速滚动白屏,上下各加 2~3 个缓冲项(bufferSize 可配置)
高度处理:分组头支持动态测量,子项仍可定高
分组头通常含文字+图标+边框,高度不可预设。解决方案分两步:
立即学习“前端免费学习笔记(深入)”;
渲染逻辑:按 Flat Index 切片 + 类型判断
从 flatData 数组中截取当前可视段后,逐项判断类型并渲染:


















