Vue3无缝滚动----vue3-seamless-scroll

Posted 2023-03-23 F班的小夏同学

在一些大屏可视化项目中，经常会用到滚动的样式。

安装

npm install vue3-seamless-scroll --save

main.js中引入

import vue3SeamlessScroll from 'vue3-seamless-scroll';
const app = createApp(App);
app.use(vue3SeamlessScroll)

使用

 <vue3-seamless-scroll
    hover-stop="true"
    :list="listData"
    hover="true"
    step="0.3">
    <div
      v-for="(item, index) in listData"
      :key="index"
      class="item"
      style="padding: 10px; margin: 5px; font-size: 14px">
      <span v-for="(value, key, ind) in item" :key="ind" class="spanClass">
        value
      </span>
    </div>
  </vue3-seamless-scroll>

组件配置

list

无缝滚动列表的数据，组件内部使用列表长度。（注意：这也是这个组件的不足之处，在项目中不支持动态更改其长度，一旦初始化只可以更改其内容，不可以更改其长度）

type: Array
required: true

v-model

通过v-model控制动画滚动和停止，默认开始滚动。

type: Boolean,
default: true,
required: false

direction

控制滚动方向，可选值up、down、left、right

type: String,
default: “up”,
required: false

isWatch

开启数据更新监听

type: Boolean,
default: true,
required: false

hover

是否开启鼠标悬停

type: Boolean,
default: false,
required: false

count

动画循环次数，默认无限循环

type: Number,
default: “infinite”,
required: false

limitScrollNum

开启滚动的数据量，只有列表长度大于等于该值才会滚动

type: Number,
default: 5,
required: false

step

步进速度

type: Number,
required: false

指南在这里

vue 基于vue-seamless-scroll无缝滚动

1.安装插件vue-seamless-scroll

npm install vue-seamless-scroll --save　　

2.导入插件

<vue-seamless-scroll></vue-seamless-scroll>
 
import vueSeamlessScroll from 'vue-seamless-scroll'
 
components: {
        vueSeamlessScroll
},　

3.配置参数

// 监听属性 类似于data概念
        computed: {
            defaultOption () {
                return {
                    step: 0.2, // 数值越大速度滚动越快
                    limitMoveNum: 2, // 开始无缝滚动的数据量 this.dataList.length
                    hoverStop: true, // 是否开启鼠标悬停stop
                    direction: 1, // 0向下 1向上 2向左 3向右
                    openWatch: true, // 开启数据实时监控刷新dom
                    singleHeight: 0, // 单步运动停止的高度(默认值0是无缝不停止的滚动) direction => 0/1
                    singleWidth: 0, // 单步运动停止的宽度(默认值0是无缝不停止的滚动) direction => 2/3
                    waitTime: 1000 // 单步运动停止的时间(默认值1000ms)
                }
            }
 
        },　　

4.单页面完整实现代码展示

<!--
  文件描述：无缝滚动组件
-->
<template>
    <div class="" style="padding: 50px;">
        <div class="page-example3" style="">
            <vue-seamless-scroll :data="listData" :class-option="defaultOption" >
                <ul class="ul-scoll">
                    <li v-for="(item, index) in listData" :key='index'>
                        <span class="title">{{item.title}}：</span><span class="date">{{item.time}}</span>
                    </li>
                </ul>
            </vue-seamless-scroll>
        </div>
    </div>
</template>
 
<script>
    import vueSeamlessScroll from 'vue-seamless-scroll'
    export default {
        name: 'Example3',
        components: {
            vueSeamlessScroll
        },
        data() {
            // 这里存放数据
            return {
                listData: []
            }
        },
        // 监听属性 类似于data概念
        computed: {
            defaultOption () {
                return {
                    step: 0.2, // 数值越大速度滚动越快
                    limitMoveNum: 2, // 开始无缝滚动的数据量 this.dataList.length
                    hoverStop: true, // 是否开启鼠标悬停stop
                    direction: 1, // 0向下 1向上 2向左 3向右
                    openWatch: true, // 开启数据实时监控刷新dom
                    singleHeight: 0, // 单步运动停止的高度(默认值0是无缝不停止的滚动) direction => 0/1
                    singleWidth: 0, // 单步运动停止的宽度(默认值0是无缝不停止的滚动) direction => 2/3
                    waitTime: 1000 // 单步运动停止的时间(默认值1000ms)
                }
            }
 
        },
        // 方法集合
        methods: {},
        // 监控data中的数据变化
        watch: {},
        // 生命周期 - 创建完成（可以访问当前this实例）
        created() {
 
        },
        // 生命周期 - 挂载完成（可以访问DOM元素）
        mounted() {
            for(let i = 0 ; i < 15 ; i++){
                let j = {
                    title:'无缝滚动第几条啊啊啊-'+i,
                    time: '2020-04-10'
                }
                this.listData.push(j)
            }
        }
    }
</script>
 
<style scoped lang="scss">
    //@import url(); 引入公共css类
    .page-example3{
        width: 400px;
        height: 200px;
        overflow: hidden;
        border: 1px solid #283dff;
        .ul-scoll{
            li{
                margin: 6px;
                padding: 5px;
                background: rgba(198, 142, 226, 0.4);
            }
        }
    }
</style>