vue3之列表无限循环滚动效果

🔮 欢迎点赞 👍٩( ´︶` )( ´︶` )۶ 收藏 🌟留言 💌 欢迎讨论!💕
🔮 本文由 【第四人称Alice】 原创,首发于 CSDN ✨✨✨
🌍 由于博主还属于前期的前端开发小白,欢迎大家留言提出更好的意见,大家共同进步!💭

声明:博主的项目是vue3+ts,node版本18.18.2 

一、介绍

插件地址:vue3-seamless-scroll - npm

Vue3.0 无缝滚动组件,支持Vite2.0,支持服务端打包、支持上下左右无缝滚动,单步滚动,并且支持复杂图标的无缝滚动,目前组件支持平台与Vue3.0支持平台一致。

二、安装

npm install vue3-seamless-scroll --save

 三、效果图

四、模板中使用

1、局部使用

<template>
    <div>
        <div class="scroll-list">
            <p>局部使用</p>
            <div class="scrollBox">
                <vue3-seamless-scroll :list="scrollListArr" class="scroll" v-if="scrollFlag" :step="0.5">
                    <div v-for="(item, index) in scrollListArr" :key="item.id">
                        <span>{{ item.description }}</span>
                    </div>
                </vue3-seamless-scroll>
            </div>
        </div>
    </div>
</template>

<style lang="less">
.scrollBox {
    border: 2px solid #f42600;
    padding: 6px 0;
    width: 300px;
    margin: 0 auto;
    height: 190px;
}
.scroll {
    height: 190px;
    overflow: hidden;
    line-height: 38px;
}
</style>
<script setup lang="ts">
import { ref, reactive, onMounted } from "vue";
import { getScrollList } from "@/api/getList";
import { Vue3SeamlessScroll } from "vue3-seamless-scroll";
let scrollListArr = reactive<any>([]);
let scrollFlag = ref(false);
const getList = async () => {
    //根据实际情况调取相应列表接口
    let res = await getScrollList();
    let data = res.data;
    if (data.code == 200) {
        scrollListArr = data.data;
        scrollFlag.value = true;
    }
};
getList();
</script>

2、全局使用

main.ts文件

import vue3SeamlessScroll from 'vue3-seamless-scroll';
const app = createApp(App);
app.use(vue3SeamlessScroll, { name: "seamless-scroll" });
app.use(router).mount("#app");

组件文件中

<template>
    <div>
        <vue3-seamless-scroll :list="scrollListArr" class="scroll" :step="0.5">
            <div v-for="(item, index) in scrollListArr" :key="item.id">
                <span>{{ item }}</span>
            </div>
        </vue3-seamless-scroll>
    </div>
</template>
<script setup lang="ts">
import { ref, reactive } from "vue";
const scrollListArr=[0,1,2,3,4]
</script>
<style lang="less">
.scrollBox {
    border: 2px solid #f42600;
    padding: 6px 0;
    width: 300px;
    margin: 0 auto;
    height: 190px;
}
.scroll {
    height: 190px;
    overflow: hidden;
    line-height: 38px;
}
</style>

五、配置参数

参数名称参数介绍默认值参数类型是否必传
list无缝滚动列表数据,组件内部使用列表长度。Array

true

v-model通过v-model控制动画滚动与停止,默认开始滚动trueBooleanfalse
direction控制滚动方向,可选值updownleftrightupStringfalse
isWatch开启数据更新监听trueBooleanfalse
hover是否开启鼠标悬停falseBooleanfalse
count动画循环次数,默认无限循环infiniteNumberfalse
limitScrollNum开启滚动的数据量,只有列表长度大于等于该值才会滚动5falsefalse
step步进速度Numberfalse
singleHeight单步运动停止的高度0Numberfalse
singleWidth单步运动停止的宽度0Numberfalse
singleWaitTime单步停止等待时间(默认值 1000ms)1000Numberfalse
isRemUnitsingleHeight and singleWidth 是否开启 rem 度量trueBooleanfalse
delay动画延时时间0Numberfalse
ease动画效果,可以传入贝塞尔曲线数值ease-inString | cubic-bezierfalse
copyNum拷贝列表次数,默认拷贝一次,当父级高度大于列表渲染高度的两倍时可以通过该参数控制拷贝列表次数达到无缝滚动效果1Numberfalse
wheel在开启鼠标悬停的情况下是否开启滚轮滚动,默认不开启falseBooleanfalse
singleLine启用单行横向滚动falseBooleanfalse

注意:需要滚动的列表所在容器必须设置样式 overflow: hidden;

贝塞尔曲线待补充...

Vue实现无限循环滚动列表,可以考虑使用两个相同的列表,一个列表用于渲染当前可见区域的数据,另一个列表用于渲染边界处的数据。当滚动到边界处时,将边界列表的数据复制到另一个列表中,实现无限循环滚动效果。 下面是一个简单的实现示例: ```html <template> <div class="list-container" ref="listContainer"> <div class="list" ref="list"> <div v-for="(item, index) in visibleData" :key="index"> {{ item }} </div> </div> <div class="list-clone" ref="listClone"> <div v-for="(item, index) in cloneData" :key="index"> {{ item }} </div> </div> </div> </template> <script> export default { data() { return { data: ["item1", "item2", "item3", "item4", "item5"], visibleData: [], cloneData: [] }; }, mounted() { // 初始化列表 this.updateList(); // 监听滚动事件 this.$refs.listContainer.addEventListener("scroll", this.handleScroll); }, beforeDestroy() { // 移除滚动事件监听器 this.$refs.listContainer.removeEventListener( "scroll", this.handleScroll ); }, methods: { // 更新列表数据 updateList() { const { data } = this; const visibleData = data.slice(); const cloneData = data.slice(0, 2); this.visibleData = visibleData; this.cloneData = cloneData; }, // 处理滚动事件 handleScroll() { const { scrollTop, scrollHeight, clientHeight } = this.$refs.listContainer; // 判断是否到达边界 if (scrollTop === 0) { // 滚动到顶部,将边界数据插入到列表底部 this.visibleData = this.cloneData.concat(this.data); this.$refs.list.scrollTop = this.$refs.list.scrollHeight / 3; } else if (scrollTop + clientHeight === scrollHeight) { // 滚动到底部,将边界数据插入到列表顶部 this.visibleData = this.data.concat(this.cloneData); this.$refs.list.scrollTop = this.$refs.list.scrollHeight / 3; } } } }; </script> ``` 这个示例中,我们使用了两个 `div` 元素,一个用于渲染当前可见区域的数据,另一个用于渲染边界处的数据。在 `mounted` 钩子函数中,我们初始化了列表数据,并添加了滚动事件的监听器。在 `beforeDestroy` 钩子函数中,我们移除了滚动事件的监听器。 `updateList` 方法用于更新列表数据,将数据分为可见区域数据和边界数据,并将它们分别渲染到两个 `div` 元素中。 `handleScroll` 方法用于处理滚动事件。当滚动到顶部时,我们将边界数据插入到列表底部,并将滚动位置设置为列表高度的三分之一;当滚动到底部时,我们将边界数据插入到列表顶部,并将滚动位置设置为列表高度的三分之一。 这样,就可以实现一个简单的无限循环滚动列表了。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值