Skill

长列表虚拟滚动优化方案

by TencentBlueKing

AI Summary

This booster provides performance optimization strategies for rendering large lists (1000+ items) using virtual scrolling in Vue3, with implementations for both fixed and dynamic item heights. It's valuable for developers building data-heavy applications like logs, audit records, and container management interfaces.

Install

# Add to your project root as SKILL.md
curl -o SKILL.md "https://raw.githubusercontent.com/TencentBlueKing/bk-bcs/master/bcs-services/bcs-project-manager/.cursor/skills/virtual-list/SKILL.md"

Description

处理超过 1000 条数据的大型列表渲染时的性能优化方案,包含定高和不定高两种策略。

长列表虚拟滚动优化方案

当列表数据量巨大(如日志列表、审计记录,n > 1000)时,直接渲染会导致 DOM 节点过多,页面卡顿。

核心原理

只渲染当前可视区域 (Viewport) 内的元素,加上缓冲区 (Buffer) 的元素。随着滚动条滚动,动态替换 DOM 内容。

1. 定高列表 (Item Height Fixed)

如果每一行高度固定(例如 40px),推荐使用轻量实现。 使用方式: `html <VirtualList :items="logList" :item-height="40" :container-height="400"> <template #default="{ item }"> <div class="log-item">{{ item.message }}</div> </template> </VirtualList> ` > 📦 获取完整组件实现:skill://virtual-list/assets/VirtualList.vue

2. 不定高列表 (Dynamic Height)

如果列表项高度不固定(如包含展开/收起、不同长度文本),计算逻辑会变得复杂。 推荐库: vue-virtual-scroller 的 DynamicScroller 组件。 `html <template> <DynamicScroller :items="items" :min-item-size="54" class="scroller" > <template #default="{ item, index, active }"> <DynamicScrollerItem :item="item" :active="active" :size-dependencies="[ item.message, ]" :data-index="index" > <div class="message">{{ item.message }}</div> </DynamicScrollerItem> </template> </DynamicScroller> </template> `

Quality Score

B

Good

75/100

Standard Compliance45
Documentation Quality72
Usefulness78
Maintenance Signal100
Community Signal100
Scored Yesterday

GitHub Signals

Stars833
Forks259
Issues230
Updated4d ago
View on GitHub

Trust & Transparency

No License Detected

Review source code before installing

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit 4d ago

833 stars — Growing Community

259 forks

My Fox Den

Community Rating

Works With

Claude Code