0

0

Vue中实现高性能双列虚拟滚动与无限加载教程

DDD

DDD

发布时间:2025-09-17 13:49:02

|

266人浏览过

|

来源于php中文网

原创

Vue中实现高性能双列虚拟滚动与无限加载教程

本文详细介绍了如何在Vue应用中为包含大量数据的可滚动列表实现高性能的虚拟滚动(Virtual Scrolling)和无限加载。通过构建一个可复用的虚拟列表组件,我们能够只渲染视口内可见的数据项,显著优化大型数据集(如数千甚至数万条记录)的渲染性能和内存消耗,有效解决因数据量过大导致的UI卡顿问题,尤其适用于Electron这类桌面应用场景。

1. 引言:大型列表渲染的性能挑战

在web应用开发中,尤其是在electron等桌面应用场景下,当需要展示包含数千甚至数万条记录的列表时,直接渲染所有数据会导致严重的性能问题,例如页面卡顿、滚动不流畅、内存占用过高等。传统的“无限滚动”通常指在用户滚动到列表底部时加载更多数据,但这并不能解决已加载数据量过大导致的渲染瓶颈。对于像用户提到的两个分别包含2000和58000个对象的列表,更高效的解决方案是采用“虚拟滚动”(virtual scrolling)技术。

虚拟滚动(或称列表虚拟化)的核心思想是:只渲染当前视口中可见的列表项,而不是一次性渲染所有数据。当用户滚动时,组件会动态计算当前应该显示哪些数据项,并只更新这部分DOM,从而极大减少DOM元素的数量,提升渲染效率和用户体验。

2. 虚拟滚动组件设计与实现

为了实现高性能的双列虚拟滚动,我们可以设计一个通用的Vue虚拟列表组件。该组件将负责管理其内部数据的渲染逻辑,而父组件只需提供完整的数据集和每个列表项的高度。

2.1 组件结构与模板 (<template>)

虚拟列表组件的模板包含三个关键部分:一个外部容器、一个撑开滚动条的“幽灵”元素,以及一个实际渲染可见内容的容器。

<template>
    <div ref="list" class="infinite-list-container" @scroll="scrollEvent($event)">
        <!-- 幽灵元素:撑开滚动条的高度,使其与完整列表高度一致 -->
        <div
            class="infinite-list-phantom"
            :style="{ height: listHeight + 'px' }"
        ></div>
        <!-- 实际渲染可见数据的容器,通过 transform 进行定位 -->
        <div class="infinite-list" :style="{ transform: getTransform }">
            <!-- 使用 slot 渲染可见数据项,data 属性将当前数据传递给父组件 -->
            <slot v-for="data in visibleData" :data="data"/>
        </div>
    </div>
</template>
  • infinite-list-container: 这是整个虚拟列表的外部容器,它设置了固定的高度和overflow: auto使其可滚动。ref="list"用于在JavaScript中获取其DOM元素,并监听@scroll事件来触发滚动逻辑。
  • infinite-list-phantom: 这是一个关键的“幽灵”元素。它没有实际内容,但其高度 (listHeight) 被设置为所有列表项的总高度。这个元素的作用是撑开父容器的滚动条,让用户能够像滚动一个完整列表一样进行滚动,而无需渲染所有DOM。
  • infinite-list: 这个元素才是真正渲染可见列表项的地方。它的位置通过CSS transform属性动态调整 (getTransform),以确保可见项始终位于正确的位置。v-for="data in visibleData"只遍历和渲染当前视口内的数据。
  • <slot>: 允许父组件自定义每个列表项的渲染方式,组件内部只负责数据的传递和位置管理。

2.2 组件逻辑与脚本 (<script>)

组件的JavaScript部分包含了数据管理、计算属性和滚动事件处理逻辑。

立即学习前端免费学习笔记(深入)”;

<script>
export default {
    name: "VirtualList",
    props: {
        // 完整的列表数据数组
        listData: {
            type: Array,
            default: () => [],
            require: true,
        },
        // 每个列表项的固定高度,这是虚拟滚动计算的关键
        itemHeight: {
            type: Number,
            default: 20, // 默认20px
            require: true,
        },
    },
    data() {
        return {
            // 容器的可见高度
            screenHeight: 0,
            // 列表项的垂直偏移量
            startOffset: 0,
            // 可视区域内第一个数据项的索引
            start: 0,
            // 可视区域内最后一个数据项的索引
            end: null,
        };
    },
    computed: {
        // 整个列表的总高度(所有数据项的高度总和)
        listHeight() {
            return this.listData.length * this.itemHeight;
        },
        // 可视区域内能容纳的列表项数量
        visibleCount() {
            return Math.ceil(this.screenHeight / this.itemHeight);
        },
        // 用于定位可视区域的CSS transform样式
        getTransform() {
            return `translate3d(0,${this.startOffset}px,0)`;
        },
        // 实际需要渲染的可见数据子集
        visibleData() {
            // 从完整数据中截取 start 到 end 之间的数据
            return this.listData.slice(
                this.start,
                Math.min(this.end, this.listData.length) // 确保 end 不超过数据总长度
            );
        },
    },
    mounted() {
        // 组件挂载后获取容器的实际高度
        this.screenHeight = this.$el.clientHeight;
        // 初始化可见区域的开始和结束索引
        this.start = 0;
        this.end = this.start + this.visibleCount;
    },
    methods: {
        // 滚动事件处理函数
        scrollEvent() {
            // 获取当前滚动位置
            let scrollTop = this.$refs.list.scrollTop;
            // 根据滚动位置计算新的开始索引
            this.start = Math.floor(scrollTop / this.itemHeight);
            // 计算新的结束索引
            this.end = this.start + this.visibleCount;
            // 计算新的垂直偏移量,用于定位 visible-list
            this.startOffset = scrollTop - (scrollTop % this.itemHeight);
        },
    },
};
</script>
  • props:
    • listData: 接收父组件传递的完整数据集。
    • itemHeight: 接收每个列表项的高度。注意:此方案假设所有列表项高度一致,这是虚拟滚动简化的关键。
  • data: 存储组件内部状态,如容器高度、偏移量和可见区域的索引。
  • computed:
    • listHeight: 计算“幽灵”元素所需的高度。
    • visibleCount: 计算在当前容器高度下,可以显示多少个列表项。
    • getTransform: 生成transform样式,用于精确地将infinite-list定位到正确的位置,使其与滚动条位置匹配。
    • visibleData: 这是最重要的计算属性,它根据start和end索引从listData中截取出当前视口需要渲染的数据子集。
  • mounted: 在组件挂载后,获取容器的实际高度并初始化可见区域的索引。
  • methods.scrollEvent: 这是核心的滚动逻辑。当容器滚动时,它会:
    1. 获取当前的scrollTop值。
    2. 根据scrollTop和itemHeight计算出当前应该从哪个数据项 (start索引) 开始渲染。
    3. 根据start和visibleCount计算出应该渲染到哪个数据项 (end索引) 结束。
    4. 计算startOffset,确保infinite-list元素能精确地跟随滚动位置,避免视觉上的跳动。

2.3 组件样式 (<style>)

<style scoped>
.infinite-list-container {
    height: 100%; /* 确保容器有固定高度 */
    overflow: auto; /* 启用滚动条 */
    position: relative; /* 内部绝对定位元素的参照 */
    -webkit-overflow-scrolling: touch; /* 优化移动端滚动体验 */
}

.infinite-list-phantom {
    position: absolute; /* 绝对定位 */
    left: 0;
    top: 0;
    right: 0;
    z-index: -1; /* 确保它在实际内容之下 */
}

.infinite-list {
    left: 0;
    right: 0;
    top: 0;
    position: absolute; /* 绝对定位 */
    text-align: center; /* 示例:内容居中 */
}
</style>
  • .infinite-list-container: 必须设置height和overflow: auto。position: relative是为了让内部的绝对定位子元素能相对于它定位。
  • .infinite-list-phantom 和 .infinite-list: 都使用position: absolute进行定位。.infinite-list-phantom通过z-index: -1确保它不会遮挡实际内容,其主要作用是提供一个虚拟的滚动高度。

3. 如何使用虚拟列表组件

在父组件中,你可以像使用任何其他Vue组件一样使用VirtualList。对于用户提到的两个独立的可滚动列,只需分别实例化两个VirtualList组件,并为它们提供各自的数据和高度。

Felvin
Felvin

AI无代码市场,只需一个提示快速构建应用程序

下载
<template>
    <div class="app-container">
        <div class="column">
            <h3>供应商列表 ({{ suppliers.length }} 条)</h3>
            <VirtualList :listData="suppliers" :itemHeight="30">
                <template v-slot="{ data }">
                    <div class="list-item">{{ data.name }} - ID: {{ data.id }}</div>
                </template>
            </VirtualList>
        </div>
        <div class="column">
            <h3>客户列表 ({{ clients.length }} 条)</h3>
            <VirtualList :listData="clients" :itemHeight="30">
                <template v-slot="{ data }">
                    <div class="list-item">{{ data.name }} - Email: {{ data.email }}</div>
                </template>
            </VirtualList>
        </div>
    </div>
</template>

<script>
import VirtualList from './VirtualList.vue'; // 导入虚拟列表组件

export default {
    components: {
        VirtualList,
    },
    data() {
        return {
            suppliers: [], // 假设从数据库加载的2000个供应商对象
            clients: [],   // 假设从数据库加载的58000个客户对象
        };
    },
    mounted() {
        // 模拟数据加载
        this.loadInitialData();
    },
    methods: {
        loadInitialData() {
            // 模拟加载供应商数据
            for (let i = 0; i < 2000; i++) {
                this.suppliers.push({ id: `S${i}`, name: `Supplier ${i}` });
            }
            // 模拟加载客户数据
            for (let i = 0; i < 58000; i++) {
                this.clients.push({ id: `C${i}`, name: `Client ${i}`, email: `client${i}@example.com` });
            }
        },
        // 可以在这里实现无限加载的逻辑,当列表滚动到底部时触发
        // 例如,在 VirtualList 组件内部可以暴露一个事件,当滚动接近底部时触发
        // 然后父组件监听这个事件,调用 API 加载更多数据并追加到 this.suppliers 或 this.clients 中
    },
};
</script>

<style scoped>
.app-container {
    display: flex;
    height: 74vh; /* 假设应用容器高度 */
    gap: 20px;
}
.column {
    flex: 1;
    border: 1px solid #ccc;
    padding: 10px;
    display: flex;
    flex-direction: column;
}
.column h3 {
    margin-top: 0;
    margin-bottom: 10px;
}
/* 为 VirtualList 容器设置高度,使其能够滚动 */
.column .infinite-list-container {
    flex-grow: 1; /* 填充剩余空间 */
    height: auto; /* 覆盖 VirtualList 内部的 height: 100% */
}
.list-item {
    height: 30px; /* 与 itemHeight prop 保持一致 */
    line-height: 30px;
    border-bottom: 1px solid #eee;
    padding: 0 5px;
    box-sizing: border-box;
}
</style>

在这个示例中,VirtualList组件被用于两个独立的列。每个列都有自己的listData和itemHeight。v-slot="{ data }"允许父组件定义每个列表项的具体渲染内容。

4. 注意事项与进阶

  1. 固定 itemHeight 的限制: 当前实现的虚拟滚动组件依赖于所有列表项高度一致的假设。如果列表项高度不固定,实现会更加复杂,需要动态测量每个项的高度,或者使用预估高度和缓存机制。对于大多数简单列表,固定高度是一个很好的起点。

  2. 无限加载 (Infinite Scroll) 的结合: 虽然虚拟滚动解决了渲染性能问题,但它并没有直接实现“无限加载”的数据获取逻辑。无限加载通常意味着当用户滚动到列表底部时,触发一次API请求来获取更多数据并追加到listData中。 要在VirtualList中实现这一点,你可以在scrollEvent方法中添加逻辑:

    scrollEvent() {
        // ... 现有计算逻辑 ...
    
        // 检测是否滚动到底部
        let scrollTop = this.$refs.list.scrollTop;
        let clientHeight = this.$refs.list.clientHeight;
        let scrollHeight = this.$refs.list.scrollHeight;
    
        // 预留一个阈值,例如距离底部100px时开始加载
        if (scrollTop + clientHeight >= scrollHeight - 100) {
            this.$emit('load-more'); // 触发自定义事件通知父组件加载更多数据
        }
    }

    父组件可以监听这个load-more事件,然后调用API获取新数据并将其push到suppliers或clients数组中。由于listData是响应式的,VirtualList会自动更新其内部状态。

  3. 性能优化

    • 节流/防抖:scrollEvent可能会频繁触发,可以考虑使用Lodash等库对scrollEvent进行节流(throttle)或防抖(debounce)处理,以减少不必要的计算。
    • 键 (Key):在v-for中使用:key属性,确保每个列表项都有唯一的键,这对于Vue高效地更新DOM至关重要。在VirtualList的<slot>中,父组件应该为每个渲染的项指定key。
  4. 初始加载状态: 在数据加载完成之前,列表可能是空的。可以添加加载指示器或骨架屏来提升用户体验。

5. 总结

通过构建一个通用的虚拟列表组件,我们能够有效地解决Vue应用中处理大型数据集时的性能瓶颈。该组件通过只渲染视口内可见的DOM元素,结合精确的滚动位置计算和CSS transform定位,实现了流畅的滚动体验。将其应用于多列场景时,只需为每列独立实例化组件并传入相应数据。结合无限加载机制,可以构建出既高性能又具备良好用户体验的动态数据列表。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

4403

2024.08.14

CSS position定位有几种方式
CSS position定位有几种方式

有4种,分别是静态定位、相对定位、绝对定位和固定定位。更多关于CSS position定位有几种方式的内容,可以访问下面的文章。

85

2023.11.23

overflow什么意思
overflow什么意思

overflow是一个用于控制元素溢出内容的属性,当元素的内容超出其指定的尺寸时,overflow属性可以决定如何处理这些溢出的内容。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1878

2024.08.15

PHP 高并发与性能优化
PHP 高并发与性能优化

本专题聚焦 PHP 在高并发场景下的性能优化与系统调优,内容涵盖 Nginx 与 PHP-FPM 优化、Opcode 缓存、Redis/Memcached 应用、异步任务队列、数据库优化、代码性能分析与瓶颈排查。通过实战案例(如高并发接口优化、缓存系统设计、秒杀活动实现),帮助学习者掌握 构建高性能PHP后端系统的核心能力。

115

2025.10.16

PHP 数据库操作与性能优化
PHP 数据库操作与性能优化

本专题聚焦于PHP在数据库开发中的核心应用,详细讲解PDO与MySQLi的使用方法、预处理语句、事务控制与安全防注入策略。同时深入分析SQL查询优化、索引设计、慢查询排查等性能提升手段。通过实战案例帮助开发者构建高效、安全、可扩展的PHP数据库应用系统。

99

2025.11.13

JavaScript 性能优化与前端调优
JavaScript 性能优化与前端调优

本专题系统讲解 JavaScript 性能优化的核心技术,涵盖页面加载优化、异步编程、内存管理、事件代理、代码分割、懒加载、浏览器缓存机制等。通过多个实际项目示例,帮助开发者掌握 如何通过前端调优提升网站性能,减少加载时间,提高用户体验与页面响应速度。

38

2025.12.30

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

115

2026.03.06

虚拟化软件介绍
虚拟化软件介绍

虚拟化软件有VMware、VirtualBox、Hyper-V、Parallels Desktop、Oracle VirtualBox等。想了解更多虚拟化的相关内容,可以阅读本专题下面的文章。

396

2023.12.20

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.0万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.7万人学习

CSS教程
CSS教程

共754课时 | 44.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号