vue-long-list-load,满足特殊条件的长列表加载。支持:1、各个节点高度不同且可自由设定 2、各个节点可修改不影响加载效果 3、可精确的滚动到指定位置。
背景
有个长列表渲染的需求,本来用vue-virtual-scroll-list的。但是每个节点的高度不一样,用着有点问题。如果也有相应的需求可以参考下我的方案。欢迎大家交流!
vue-long-list-load
满足特殊条件的的长列表加载。 列表内各个节点高度不一,各个节点可以进行修改,定位到指定位置指定节点。 www.npmjs.com/package/vue…
主要内容
- vue-long-list-load 与 vue-virtual-scroll-list 对比
- vue-long-list-load实现思路
- 基本代码
- 插件使用方式
- 插件参数说明
一、组件对比
vue-long-list-load ,vue-virtual-scroll-list两个插件各有优缺点,当我们在选择插件的时候要选择最适合应用场景的插件。下面是两个插件的基本功能对比。vue-long-list-load 主要特点是适用于各个节点尺寸不统一的场景,vue-virtual-scroll-list更适用于高度统一节点以列表长度以w计的这种列表。
组件 | vue-long-list-load | vue-virtual-scroll-list |
---|---|---|
npm地址 | www.npmjs.com/package/vue… | www.npmjs.com/package/vue… |
核心 | 先空dom占位,显示区域内组件挂载显示 | 计算当前显示区域内要显示的组件挂载 |
横向 | 支持 | 支持 |
列表内高度一致 | 支持 | 支持 |
列表内高度不一致 | 支持 | 支持不好 |
滚动到指定组件 | 支持 | 高度不一致时计算不准确 |
滚动事件 | 支持 | 支持 |
组件高度改变事件 | 支持 | 支持 |
隐藏组件 | 支持 | 不支持 |
二、实现思路
主要思想就是通过\color{red}{虚拟dom}虚拟dom占位各个节点,根据可显示视口的变化来展示该展示的节点。影响可显示视口的因素的监听,页面整体宽高变化、节点高度变化、页面的滚动定位到某一个节点等都可能会影响到视口的变化。当视口发生变化后计算可显示的节点,将可显示的节点挂载上节点的组件,不在视口内的节点销毁组件紧保留一个空的div。下图为实现思路的流程图。
三、关键方法源码分析
主入口html结构如下,\color{red}{v-for}v−for 展示长列表长度的的节点,并且通过:style 来设置一个\color{red}{最小高度}最小高度,设置最小高度的原因是这个高度值可能不准确,当真正组件渲染完之后计算出最准确的高度,如果直接height的话可能会使节点内的组件展示不全。同时每个节点设置唯一id(scrollItem_ 唯一标识),在根据数据获取dom信息时候使用。节点组件定义了唯一的class (long-item- 唯一标识),主要用来挂载真实列表组件,同时监听组件的高度变化。showList[index]来控制节点是否时候显示的唯一标识。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<!--html代码--> < template > < div : :style="{'min-height': (item.height>=0?item.height:height) + 'px'}" :key="item[dataKey]" :id="'scrollItem_' + item[dataKey]" v-for="(item,index) in dataList" > < long-item v-if = "showList[index]" :dataKey = "dataKey" :item = "item" :boxHeight = "item.height||0" :direction = "direction" :heightChange = "heightChange" :extendCcomments = "extendCcomments" > </ long-item > </ div > </ template > |
当showList[index]为true的时候,对应的节点显示。long-item 在mounted生命周期时,回调extendCcomments。通过\color{red}{Vue.extend Profile}Vue.extendProfile挂载到对应的dom上。componentProps是节点组件传过来的一些参数,在挂载的时候全部挂载上。
1
2
3
4
5
6
7
8
9
10
|
<!--挂载组件--> extendCcomments(item){ this .componentProps.item=item var Profile = Vue.extend( this .dataComponent); // 创建 Profile 实例,并挂载到一个元素上 new Profile({ propsData: this .componentProps } ).$mount( '.long-item-' +item[ this .dataKey]); } |
通过\color{red}{element-resize-detector}element−resize−detector来监听dom尺寸的变化,每个节点的宽高发生变化的时候,并且与原来的尺寸不一样回调heightChange方法,进行尺寸的更新及显示节点的操作计算。
1
2
3
4
5
6
7
8
|
<!--每个节点尺寸发生变化--> this .$nextTick(()=> { this .$DomListener.listenTo(document.getElementById( 'long-item-' + this .item[ this .dataKey]), (element)=>{ if ( this .boxHeight != element[ this .directionConfig.width]){ this .heightChange( this .item, element[ this .directionConfig.width]) } }) }); |
获取可显示的视口区域的方法,页面滚动和尺寸变化都会调用到这个方法,所以这个方法在调用的时候做防抖处理300ms内有连续调用只会执行最后一次调用,要不然会频繁计算影响性能。可显示视口区域计算方式是当前视口 及 前后两个视口总共三个视口的尺寸。这样在小的滚动范围内会有较好的体验。
1
2
3
4
5
6
7
8
9
10
11
12
13
|
getShowLimit(startTop) { const scrollTop = startTop || this .scrollWrap[ this .directionConfig.scrollTo] || 0; // 滚动距离 this .viewClientHeight = this .scrollWrap[ this .directionConfig.width]; // 可视区域高度 this .scrollTop = scrollTop this .showStart = scrollTop - this .viewClientHeight this .showEnd = scrollTop + 2* this .viewClientHeight if ( this .setTopTimer){ clearTimeout( this .setTopTimer) } this .setTopTimer = setTimeout(() => { this .setItemTopheight() }, 300); }, |
根据高度或者宽度来计算节点是否显示,因为这个计算量比较大避免而且这个方法与其他方法没有什么关联,直接单独开一个\color{red}{独立线程}独立线程进行计算。通过引入\color{red}{simple-web-worker}simple−web−worker这个插件单独开一个线程进行计算显示节点。计算方法主要有三点:当前节点的开头在显示视口内、当前节点的结尾在显示视口内、当前节点开头和结尾都不在显示视口内。分为这三种情况,只要满足一种情况,则该节点就显示在显示视口中。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
// 根据高度计算节点是否显示 setItemTopheight(){ let stsartId = this .dataList[0]&& this .dataList[0][ this .dataKey] let startDom = stsartId && document.getElementById( 'scrollItem_' +stsartId) let startTop = startDom ? startDom[ this .directionConfig.offset] : 0 this .worker = this .$worker.run((dataList,showStart,showEnd, startTop,hideIds,dataKey,height) =>{ let topHeight = startTop; // 题目顶部距离顶部距离 let bottomHeight = 0; // 题目底部距离顶部距离 let showList = [] for (let i=0,len=dataList.length;i<len;i++){ let item = dataList[i] if (hideIds.indexOf(item[dataKey]) != -1){ showList[i] = false ; continue ; } bottomHeight = topHeight + (item.height>=0?item.height:height) // 判断 1.题目顶部在显示范围内 2.题目底部在显示范围内 3.题目顶部和底部都不在显示范围内 if ((topHeight>=showStart && topHeight<=showEnd)|| (bottomHeight>=showStart && bottomHeight<=showEnd)|| (topHeight<showStart && bottomHeight>showEnd) ){ showList[i] = true } else { showList[i] = false } topHeight += ((item.height>=0?item.height:height)); } return showList }, [ this .dataList, this .showStart, this .showEnd, startTop, this .hideIds, this .dataKey, this .height]) .then(res => { this .showList = res }) this .worker = null }, |
四、使用方式
安装vue-long-list-load:
1
|
npm install vue-long-list-load --save |
项目内调用
1
2
3
4
5
6
7
8
9
10
|
< long-list ref = "vueLongList" dataKey = 'id' scrollWrap :dataList = "dataList" :dataComponent = "dataComponent" :componentProps = "componentProps" height = 100 > </ long-list > |
五、参数说明
参数 | 说明 | 类型 | 必填 | 可选值 | 默认值 |
---|---|---|---|---|---|
scrollWrapId | 列表滚动容器id | string | true | — | — |
dataKey | 节点数据内唯一键值 | String | true | — | — |
dataList | 列表数据 | Array | true | 具体见下方说明 | — |
dataComponent | 自定义的节点组件 | — | true | — | — |
ref | 调用组件内部方法 | string | false | — | — |
direction | 滚动方向 | Number | false | 0:纵向,1横向 | 0 |
hideIds | 列表中需要隐藏的节点 | Array | false | 具体见下方说明 | [] |
height | 节点高度 | Number | false | — | 100 |
componentProps | 节点组件要传递的参数 | Object | false | — | {} |
scroll | 滚动区域内滚动回调方法 | Function | false | - | — |
resized | 某个节点宽高发生变化回调方法 | Function | false | 具体见下方说明 |
部分参数说明
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<--假设 dataKey=id--> <--列表中需要隐藏的节点--> hideIds:[1, 2] <--列表数据 dataList 内 height 为 **Number**。--> dataList:[ {id:1,height:100}, {id:2,height:200}, {id:3,height:300}, {id:4,height:300}, {id:5,height:300} ] <--节点高度--> height:100 <--如果dataList的数据内有height值 不需要设置这个height--> <--如果dataList 和 height 都不传递的话,默认为100 可能滚动略有卡顿;--> <--建议在每个高度都不相同的时候通过dataList传递,都相同时候通过height传递--> <--某个节点宽高发生变化回调方法 返回参数为id 与高度--> resized(id, height){ } |
总结
项目中实践数据,基本每个节点至少500个dom节点,平均也在800个dom节点以上,用vue-long-list-load 不在渲染区域内的题目只会渲染2个dom节点。按正常800左右个dom节点的题目计算 一般渲染区域渲染的节点在9个左右,如果是n节点的列表 ,每次加载 dom操作都减少(n-9)x(800-2)个dom的渲染,如果\color{red}{1000个节点}1000个节点的列表每次加载和操作的时候相当于减少了\color{red}{726180}726180个dom节点的渲染。首次渲染还有修改后的重绘都大大减少了dom的渲染加快了加载速度提高了用户体验。 此方案已经在项目中实践一段时间,用户反馈很好。如果大家也有类似的场景需求,欢迎大家使用!交流!
以上就是如何让vue长列表快速加载的详细内容,更多关于vue 长列表快速加载的资料请关注服务器之家其它相关文章!
原文链接:https://juejin.cn/post/6943473199157870622