居于ant-design-vue封装的虚拟列表组件av-table
av-table亮点
- 开箱即用,不破坏antd原有a-table的所有属性和方法,不破坏布局
- 能加载10W级别以上的数据而不卡顿
- 最重要的是,可以无缝移植到原有的居于ant-design-vue(3.2.20版本)项目中
原理
- 简单说一下原理吧,请看下图:
源码地址
简介
- 用ant-design-vue的用户可能会遇到过一些性能上的烦恼:当页面中表格数据量达到一定量级的时候,滚动页面会变得非常卡顿。由于开发过程中疏忽了卡顿问题,等到项目进度已经100%的时候再回头去优化,发现如果要替换掉项目中原有的a-table代码改动量大,时间成本特别高,还存在一定的未知风险。未来解决这个烦恼,本人稍微改动了一下a-table,使其加载10w条数据也不会出现卡顿。所以,av-table就出现了。
- av-table是居于ant-design-vue(版本3.2.20) 的 a-table组件封装的虚拟列表组件。 av-table组件继承了a-table的所有属性和方法,用户在使用的时候可以直接参照a-table的api文档进行开发, 当然该虚拟列表组件新增了两个a-table没有的关键属性,需要使用者特别注意的,具体属性会在下面注明。
- 使用前一定要安装ant-design-vue(版本3.2.20)依赖
- 使用过程中,可能要传一下table的scroll.y,其中av-table的scroll参数与a-table的scroll参数一致 ( 原 ant-design-vue a-table 组件 API 传送地址点这里)
额外新增两个参数如下:
参数 | 说明 | 类型 | 默认值 | 是否必填 |
---|---|---|---|---|
virtualized | 是否开启虚拟列表功能 | boole | false | 否 |
itemHeight | 行高设置,当传入该值时,虚拟列表会优先根据该行高进行计算,当用户不传该值时,会根据 size 值选择行高,分别对应关系为:default = 55, middle = 47 small = 39 | number | 0 | 否 |
av-table使用示例代码
main.ts代码如下
ts
import { createApp } from "vue";
//记得引入antd.css,否则会样式丢失
import "ant-design-vue/dist/antd.css";
import App from "./App.vue";
import AVTable from "av-table";
createApp(App).use(AVTable).mount("#app");
App.vue代码如下
ts
<template>
<div id="app">
<AVTable
:dataSource="dataSource"
:virtualized="true"
:columns="columns"
:scroll="{ y: '400px' }"
:pagination="false"
></AVTable>
</div>
</template>
<script setup>
const dataSource = Array.from(
Array(1000).fill({
key: "1",
name: "蒋哥哥",
age: 18,
address: "东莞xxxX电子厂",
tag: "宇宙无敌帅气",
}),
(item, index) => ({ ...item, name: `${item.name}${index}`, key: index })
);
const columns = [
{
title: "名称",
dataIndex: "name",
key: "name",
},
{
title: "年龄",
dataIndex: "age",
key: "age",
},
{
title: "特征",
dataIndex: "tag",
key: "tag",
},
{
title: "工作单位",
dataIndex: "address",
key: "address",
},
];
</script>
<style scoped>
html {
height: 100%;
}
body {
height: 100%;
margin: 0;
}
#app {
height: 100%;
}
</style>