vue 表格组件 vxe-table 实现虚拟滚动与无需滚动加载

在处理大数据量表格时,性能是首要考虑的问题。vxe-table 提供了强大的虚拟滚动能力,结合滚动事件即可实现"滚动到底部自动加载更多"的无感加载体验,几行代码就能完成。

功能概述

  • 虚拟滚动:仅渲染可视区域内的行,大幅减少 DOM 节点数量,支持海量数据流畅滚动。
  • 滚动加载:监听滚动事件,触底时自动请求下一页数据并追加到列表中,用户无感知。
  • 分页兼容:滚动加载可与分页并存,用户看不到分页按钮,体验上像是无限下拉。

核心配置

启用纵向虚拟滚动

javascript 复制代码
virtualYConfig: {
  enabled: true, // 启用虚拟滚动
  gt: 0          // 数据量超过 0 行即启用,设为 0 表示始终启用
}
  • enabled:总开关。
  • gt:阈值,超过该行数才启用虚拟滚动。设为 0 表示始终启用。
  • 需要为表格设置固定高度,虚拟滚动依赖可视区域高度计算渲染范围。

监听滚动事件

javascript 复制代码
const gridEvents = {
  scroll({ isTop, isBottom }) {
    if (isBottom) {
      loadList(20) // 触底加载更多
    }
  }
}
  • scroll 事件返回 isTop 和 isBottom,用于判断是否滚动到顶部或底部。
  • 在 isBottom 为 true 时调用加载函数。

防止重复加载

javscript 复制代码
const loadList = (size = 200) => {
  if (gridOptions.loading) {
    return // 加载中则跳过,避免重复请求
  }
  gridOptions.loading = true
  // ... 请求数据
  gridOptions.loading = false
}

使用 loading 状态作为锁,确保上一次请求完成后才能触发下一次加载。

代码

html 复制代码
<template>
  <div>
    <vxe-grid v-bind="gridOptions" v-on="gridEvents"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const gridOptions = reactive({
  border: true,
  loading: false,
  showOverflow: true,
  showHeaderOverflow: true,
  showFooterOverflow: true,
  height: 600,
  columnConfig: {
    resizable: true
  },
  virtualYConfig: {
    enabled: true,
    gt: 0
  },
  columns: [
    { type: 'seq', width: 80 },
    { field: 'id', title: 'ID', width: 120 },
    { field: 'name', title: 'Name' },
    { field: 'role', title: 'Role' },
    { field: 'sex', title: 'Sex', width: 100 }
  ],
  data: []
})

let rowKey = 0
// 模拟行数据
const loadList = (size = 200) => {
  if (gridOptions.loading) {
    return
  }
  // 模拟后端接口
  gridOptions.loading = true
  setTimeout(() => {
    const dataList = []
    for (let i = 0; i < size; i++) {
      rowKey++
      dataList.push({
        id: `${rowKey}`,
        name: 'Test' + rowKey,
        role: 'Developer' + rowKey,
        sex: '男'
      })
    }
    gridOptions.data = [...gridOptions.data, ...dataList]
    gridOptions.loading = false
  }, 300)
}

const gridEvents = {
  scroll({ isTop, isBottom }) {
    if (isTop) {
      console.log('触碰到顶部')
    }
    if (isBottom) {
      console.log('触碰到底部')
      loadList(20)
    }
  }
}

loadList(20)
</script>

关键代码说明

滚动事件与触底加载

javascript 复制代码
scroll({ isTop, isBottom }) {
  if (isBottom) {
    loadList(20)
  }
}
  • isBottom 表示已滚动到距底部一定范围内,是触发加载的时机。
  • 也可使用 scroll-boundary 事件,通过 virtualYConfig.threshold 设置阈值,例如距底部 30px 内触发

数据追加与响应式

javascript 复制代码
gridOptions.data = [...gridOptions.data, ...dataList]

使用展开运算符创建新数组并赋值给 gridOptions.data,确保 Vue 能检测到数据变化并触发更新。

加载状态锁

javascript 复制代码
if (gridOptions.loading) return

loading 既是 UI 状态,也是防止重复请求的锁。滚动过程中可能频繁触发 scroll 事件,若没有这个判断,会发起多次重复请求。

进阶用法:scroll-boundary 事件

除了 scroll 事件,vxe-table 还提供了 scroll-boundary 事件,通过阈值触发加载,更加精准。

html 复制代码
<vxe-grid v-bind="gridOptions" @scroll-boundary="scrollBoundaryEvent"></vxe-grid>
javascript 复制代码
scrollY: {
  enabled: true,
  gt: 0,
  threshold: 30 // 距底部 30px 内触发
}

scrollBoundaryEvent({ direction }) {
  if (direction === 'bottom') {
    loadList(20)
  }
}
  • threshold:设置触发阈值,当滚动距离达到该范围内时触发事件。
  • direction:返回触发方向,'bottom' 表示触底。

通过 virtualYConfig 启用虚拟滚动,结合 scroll 或 scroll-boundary 事件触底加载,即可用极少的代码实现高性能的滚动加载表格。这种方案特别适合数据量大、需要连续浏览的场景,能显著提升用户体验。

https://vxetable.cn

相关推荐
tryCbest16 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
Lanwarf-前端开发1 天前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
FRing031 天前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
小码哥0681 天前
智慧物业系统源码定制:公告发布范围与住户阅读记录设计
前端·javascript·vue.js·物业管理·物业系统·物业软件
码云社区2 天前
Java在线租房系统源码:VR看房素材、房源图片与内容维护方案
java·vue.js·vr·租房小程序·在线租房·看房租房
cc.ChenLy2 天前
无法修改 el-dialog 样式原因及解决办法
javascript·vue.js·elementui
AI开源软件2 天前
Vue3+SpringBoot3 业务配置统一管理:接管、保存与回退怎样保留有效值
java·前端·vue.js·spring boot·vue·ruoyi office
1-1=02 天前
Vue 脚手架
前端·javascript·vue.js
一个游离的指针2 天前
Vue2:vue-router
前端·javascript·vue.js
用户4514194293222 天前
2026 Vue 生态分析:底层重写了一遍,升级却几乎零成本
vue.js