Vue实现无限滚动组件的整体思路和方法是什么
Admin 2022-12-07 群英技术资讯 354 次浏览
对于列表类型的大量数据,前端展示往往采用 分页 和 无限滚动 的方式来展示,对于用户来说,鼠标滚轮和触控屏使滚动行为要比点击更快更容易。 element-plus 组件库提供了简单的 vue 指令,就可以轻易的实现
但是 element-plus
只支持无限向下滚动,不支持无限向上滚动,同时也没缺少丰富的 钩子函数,我们无法在这个基础上更好地 利用和改造滚动过程,所以,我们可以自己封装一个更具有个性化的组件
scrollTop
:滚动条滚动距离scrollHeight
:滚动条的实际高度clientHeight
:元素的高度随着滚动条滚到底部,此时 scrollTop + clientHeight = scrollHeight,那么此时就可以判断到达底部了
const app = createApp(App); app.directive('infinite-scroll', { mounted(el, binding) {}, });
为什么使用自定义指令实现?
自定义指令
相对于 组件
来说能够更好地操作dom元素
el
可以访问被添加指令的元素binding.value
可以访问调用指令时传递的参数<ul v-infinite-scroll="{}"> // 配置参数 <li v-for="i in dataArr">{{ i }}, len: {{ dataArr.length }}</li> </ul>
那么我们整体结构和整体思路就有了,就不难写出如下代码:
// 为 el 单独指定类型 type InfiniteScrollEl = HTMLElement & { // 给 el 添加一个存储变量的空间 [__SCOPE__]: { onScroll: () => void; }; }; interface DirectiveOpt { itemHeight: number; /// 内部每一列数据的高度 rate: number; // 每次更新刷新数据的频率 load: (dir: 'down' | 'up') => void; // 维护数据源的函数 } // 获取并初始化配置选项 const getOptions = (binding: DirectiveBinding<DirectiveOpt>) => { const itemHeight = binding.value.itemHeight || 60; const rate = binding.value.rate || 1; const load = binding.value.load || (() => {}); return { itemHeight, rate, load }; }; app.directive('infinite-scroll', { async mounted(el: InfiniteScrollEl, binding: DirectiveBinding<DirectiveOpt>) { await nextTick(); // 确保父元素加载完毕 const { rate, load } = getOptions(binding); const onScroll = () => { // 向下刷新 if (el.scrollTop + el.clientHeight >= el.scrollHeight) { for (let i = 0; i < rate; i++) { load('down'); } } // 向上刷新 if (el.scrollTop <= 0) { for (let i = 0; i < rate; i++) { load('up'); } } }; el[__SCOPE__] = { onScroll, }; el.addEventListener('scroll', onScroll); }, unmounted(el) { const { onScroll } = el[__SCOPE__]; el.removeEventListener('scroll', onScroll); }, });
在组件被完全渲染完毕的时候,立即给 el
添加滚动事件 的处理函数,同时将这个回调函数挂载在 el
上,组件被销毁的时候,删除滚动事件
调用:
<script lang="ts" setup> import { reactive } from 'vue'; const dataArr = reactive([1, 2, 3, 4, 5]); let i = 0; const load = (dir: 'down' | 'up') => { if (dir === 'down') { dataArr.push(dataArr.length + 1); } else { dataArr.unshift(i--); } }; </script> <template> <ul v-infinite-scroll="{ load, itemHeight: 60 }"> <li v-for="i in dataArr">{{ i }}, len: {{ dataArr.length }}</li> </ul> </template> <style scoped> ul { padding: 0; margin: 0; width: 400px; height: 200px; overflow: auto; } li { box-sizing: border-box; list-style: none; margin-bottom: 10px; height: 50px; background-color: skyblue; text-align: center; line-height: 50px; } </style>
此时会带来诸多 bug
:
scrollTop === 0
,会触发向上刷新scrollTop === 0
,向上滚动滚轮无法触发滚动事件这里的解决方案有很多种,我们采用一种比较简单易懂的方法:
组件加载完毕的时候,给列表顶部 预留一点位置,这样不会导致第一次向上滚动无法触发滚动事件,每次向上滚动的时候,列表顶部刷新多少数据,就让列表的 scrollTop
位于 新数据与旧数据的分界处
async mounted(el: InfiniteScrollEl, binding: DirectiveBinding<DirectiveOpt>) { // ... const { rate, load, itemHeight } = getOptions(binding); el.scrollTop = itemHeight; // 组件加载完毕,让列表视口顶部为第二项数据 const onScroll = () => { if (el.scrollTop + el.clientHeight >= el.scrollHeight - 10) { for (let i = 0; i < rate; i++) { load('down'); } await nextTick(); // 等待新增的元素加载完毕 } if (el.scrollTop <= 10) { for (let i = 0; i < rate; i++) { load('up'); } await nextTick(); // 等待新增的元素加载完毕 el.scrollTop = rate * itemHeight; } }; // ... },
为了解决 滚动条位于顶部的时候无法向上刷新,在触发向上滚动的时候,立即改变列表 scrollTop
值,让列表视口顶部处于 刷新的数据的底部,这样就模拟了模拟了向上刷新的过程了
此外为了防止滚动过程的卡顿,我们让刷新条件多了 10px
的 缓冲区域
很多小伙伴可能会问了?这个值不就是 scrollTop
?真的是这样的吗
一旦触发向上更新,原先 scrollTop
记录的位置随着新数据的增加被 挤下来,那么新的 scrollTop
值代表的一定不是原先位置了
我们得从 getOptions
中多添加一个处理 获取偏移值的函数,这个函数在每次 onScroll
执行完毕的时候触发
async mounted(el: InfiniteScrollEl, binding: DirectiveBinding<DirectiveOpt>) { // ... + const { rate, load, itemHeight, scrolledCb } = getOptions(binding); + let topAddedPx = 0; // 顶部新增的高度 + let offset = 0; // 偏移值 const onScroll = async () => { if (el.scrollTop + el.clientHeight >= el.scrollHeight - 10) { for (let i = 0; i < rate; i++) { load('down'); + offset = el.scrollTop - itemHeight - topAddedPx; } await nextTick(); // 等待新增的元素加载完毕 } if (el.scrollTop <= 10) { for (let i = 0; i < rate; i++) { load('up'); + topAddedPx += itemHeight; } await nextTick(); // 等待新增的元素加载完毕 el.scrollTop = rate * itemHeight; } + offset = el.scrollTop - itemHeight - topAddedPx; + scrolledCb(offset); }; // ... },
首先我们声明了两个变量 offset
获取实时的偏移值,topAddedPx
记录向上刷新时候新增的高度
在 onScroll
结束的时候 offset
等于 此时的位置 减去 向上刷新时候新增的高度,但是别忘了还要减去 itemHeight
,因为在组件初始化的时候,我们预留了一个 itemHeight
的高度
调用:
<script lang="ts" setup> // ... const scrolledCb = (offset: number) => { console.log(offset); }; </script> <template> <ul v-infinite-scroll="{ load, itemHeight: 60, scrolledCb }"> <li v-for="i in dataArr">{{ i }}, len: {{ dataArr.length }}</li> </ul> </template>
有时候,我们需要在 监听 开始滚动 和 结束滚动 的特定时刻
首先,在 getOptions
中多添加一个处理 获取切换滚动状态时刻的函数
async mounted(el: InfiniteScrollEl, binding: DirectiveBinding<DirectiveOpt>) { // ... const { rate, load, itemHeight, scrolledCb, scrollingCb } = getOptions(binding); // ... let isScrolling = ref<boolean>(false); // 记录是否触发滚动 let isNotFirst = false; // 第一次滚动不触发 let timer: NodeJS.Timeout | null = null; // 监听是否滚动,如果监听值改变,立即触发滚动时刻的回调函数 watch(isScrolling, () => { scrollingCb(isScrolling.value); }); const onScroll = async () => { if (isNotFirst) isScrolling.value = true; isNotFirst = true; timer && clearTimeout(timer); timer = setTimeout(() => { isScrolling.value = false; }, 200); // ... }; // ... },
scrollingCb
,并开启一个定时器,如果在 200ms
内没有再次滚动就断定为停止滚动,再次触发 scrollingCb
、200ms
内再次滑动滚轮,清空定时器,重新计时调用:
<script lang="ts" setup> const scrollingCb = (isScrolling: boolean) => { console.log(isScrolling); }; </script> <template> <ul v-infinite-scroll="{ load, itemHeight: 60, scrollingCb }"> <li v-for="i in dataArr">{{ i }}, len: {{ dataArr.length }}</li> </ul> </template>
还可以设置 隐藏滚动条,让无限滚动的过程变得更加自然,只需要在使用 无限滚动指令 的元素上添加 element::-webkit-scrollbar { display: none; }
const __SCOPE__ = 'scope'; // 为 el 单独指定类型 type InfiniteScrollEl = HTMLElement & { // 给 el 添加一个存储变量的空间 [__SCOPE__]: { onScroll: () => void; }; }; interface DirectiveOpt { itemHeight: number; /// 内部每一列数据的高度 rate: number; // 每次更新刷新数据的频率 load: (dir: 'down' | 'up') => void; // 维护数据源的函数 scrolledCb: (offset: number) => void; // 获取偏移值 scrollingCb: (isScrolling: boolean) => void; // 获取改变滚动状态的时刻 } // 获取并初始化配置选项 const getOptions = (binding: DirectiveBinding<DirectiveOpt>) => { const itemHeight = binding.value.itemHeight || 60; const rate = binding.value.rate || 1; const load = binding.value.load || (() => {}); const scrolledCb = binding.value.scrolledCb || (() => {}); const scrollingCb = binding.value.scrollingCb || (() => {}); return { itemHeight, rate, load, scrolledCb, scrollingCb }; }; app.directive('infinite-scroll', { async mounted(el: InfiniteScrollEl, binding: DirectiveBinding<DirectiveOpt>) { await nextTick(); const { rate, load, itemHeight, scrolledCb, scrollingCb } = getOptions(binding); el.scrollTop = itemHeight; let topAddedPx = 0; let offset = 0; let isScrolling = ref<boolean>(false); let isNotFirst = false; let timer: NodeJS.Timeout | null = null; watch(isScrolling, () => { scrollingCb(isScrolling.value); }); const onScroll = async () => { if (isNotFirst) isScrolling.value = true; isNotFirst = true; timer && clearTimeout(timer); timer = setTimeout(() => { isScrolling.value = false; }, 200); if (el.scrollTop + el.clientHeight >= el.scrollHeight - 10) { for (let i = 0; i < rate; i++) { load('down'); offset = el.scrollTop - itemHeight - topAddedPx; } await nextTick(); // 等待新增的元素加载完毕 } if (el.scrollTop <= 10) { for (let i = 0; i < rate; i++) { load('up'); topAddedPx += itemHeight; } await nextTick(); // 等待新增的元素加载完毕 el.scrollTop = rate * itemHeight; } offset = el.scrollTop - itemHeight - topAddedPx; scrolledCb(offset); }; el[__SCOPE__] = { onScroll, }; el.addEventListener('scroll', onScroll); }, unmounted(el) { const { onScroll } = el[__SCOPE__]; el.removeEventListener('scroll', onScroll); }, });
到此,关于“Vue实现无限滚动组件的整体思路和方法是什么”的学习就结束了,希望能够解决大家的疑惑,另外大家动手实践也很重要,对大家加深理解和学习很有帮助。如果想要学习更多的相关知识,欢迎关注群英网络,小编每天都会给大家分享实用的文章!
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:mmqy2019@163.com进行举报,并提供相关证据,查实之后,将立刻删除涉嫌侵权内容。
猜你喜欢
这篇文章主要为大家详细介绍了JavaScript canvas实现刮刮乐案例,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
javascript将字符串转换为8进制的方法:1、使用parseInt()函数将字符串转为十进制数,语法“parseInt(字符串)”;2、使用toString()函数将十进制数转为8进制数,语法“十进制数.toString(8)”。
用node.js怎样做命令行游戏?其实要实现一个命令行游戏并不困难,这篇文章就以实现贪吃蛇游戏为例,给大家分享一下实现命令行游戏的原理及实现代码,感兴趣的朋友可以参考。
这篇文章主要介绍了Vue3 列表界面数据展示,文章主要详介绍的内容就是做的就是把打到页面的数据,带样式,也就是说好看点显示,需要的朋友可以参考一下
这篇文章主要为大家详细介绍了JavaScript实现Tab栏切换特效,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
成为群英会员,开启智能安全云计算之旅
立即注册Copyright © QY Network Company Ltd. All Rights Reserved. 2003-2020 群英 版权所有
增值电信经营许可证 : B1.B2-20140078 粤ICP备09006778号 域名注册商资质 粤 D3.1-20240008