使用vue3-seamless-scroll实现列表自动滚动播放

vue3-seamless-scroll组件支持上下左右无缝滚动，单步滚动，并且支持复杂图标的无缝滚动。

核心特性

1. 多方向无缝滚动

   支持上下、左右四个方向的自动滚动，通过 direction 参数控制（默认 up），适用于新闻轮播、数据大屏等场景。

2. 动态交互控制

   • 通过 v-model 绑定布尔值控制滚动启停。

   • 支持鼠标悬停暂停（hover: true）和滚轮手动滚动（wheel: true）。

3. 响应式与动态数据

   可监听数据变化（isWatch: true），当列表长度达到 limitScrollNum（默认5）时触发滚动，适合动态加载内容。

4. 复杂场景适配

   • 表格滚动：通过拆分表头与内容区域，避免表头跟随滚动（需复制一个隐藏表头的表格包裹组件）。

   • 单步滚动 ：通过 singleHeight 或 singleWidth 设置单步停止距离，结合 singleWaitTime 控制停留时间

安装与配置

1. 安装方式

npm install vue3-seamless-scroll --save
# 或
yarn add vue3-seamless-scroll

2. 组件注册

• 全局注册（推荐）：

  // main.js
  import { createApp } from 'vue';
  import vue3SeamlessScroll from "vue3-seamless-scroll";
  const app = createApp(App);
  app.use(vue3SeamlessScroll);

• 局部注册：

  <script setup>
  import { Vue3SeamlessScroll } from "vue3-seamless-scroll";
  </script>

3. 关键配置参数

参数	类型	说明
list	Array	必填，滚动数据列表
direction	String	滚动方向：up/down/left/right（默认 up）
step	Number	步进速度，值越大滚动越快
copyNum	Number	列表拷贝次数（默认1），用于无缝衔接
hover	Boolean	是否启用鼠标悬停暂停（默认 false）
singleHeight	Number	垂直单步滚动停止高度（设为0则连续滚动）
singleWidth	Number	水平单步滚动停止宽度

使用示例

基础列表滚动

<template>
  <vue3-seamless-scroll 
    :list="list" 
    direction="up" 
    :hover="true"
    class="scroll-container"
  >
    <div v-for="(item, index) in list" :key="index" class="item">
      {{ item.title }}
    </div>
  </vue3-seamless-scroll>
</template>

<style>
.scroll-container {
  height: 300px;
  overflow: hidden;
}
.item {
  padding: 12px 0;
}
</style>

表格内容滚动（保留表头）

<template>
  <div class="scroll-wrap">
  <div class="scroll-header">
    <ul class="scroll-ul">
      <li class="scroll-li">
        <span style="min-width: 80px; width: calc(100% - 180px)">标题</span>
        <span style="width: 180px">日期</span>
      </li>
    </ul>
  </div>
  <div class="scroll-content">
    <vue3-seamless-scroll class="scroll-list" :list="list" :hover="true" :step="0.4" :wheel="true" :isWatch="true">
      <ul class="scroll-ul" v-for="(item, index) in list" :key="index">
        <li class="scroll-li">
          <span style="min-width: 80px; width: calc(100% - 180px)">{{ item.title }}</span>
          <span style="width: 180px">{{ item.date }}</span>
        </li>
      </ul>
    </vue3-seamless-scroll>
  </div>
</div>
</template>
 
<script lang="ts" setup>
import { ref } from 'vue';
import { Vue3SeamlessScroll } from "vue3-seamless-scroll";
 
const list = ref([
  {
    title: "Vue3.0 无缝滚动组件展示数据第1条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第2条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第3条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第4条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第5条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第6条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第7条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第8条",
    date: Date.now(),
  },
  {
    title: "Vue3.0 无缝滚动组件展示数据第9条",
    date: Date.now(),
  },
]);   
</script>
 
<style scoped>
.scroll-wrap {
  width: 500px;
  height: 350px;
  overflow: hidden;
}
.scroll-header,
.scroll-content {
  width: 100%;
	display: flex;
}
.scroll-list {
  width: 100%;
  overflow: hidden;
}
.scroll-ul {
  width: 100%;
  display: flex;
  flex-direction: column;
}
.scroll-li {
  width: 100%;
  display: flex;
  line-height: 35px;
}
.scroll-li > span {
  display: flex;
  height: 35px;
  line-height: 35px;
  border-top: 1px solid #dcdfe6;
  border-left: 1px solid #dcdfe6;
  padding-left: 5px;
  overflow: hidden;
}
.scroll-li > span:last-child {
  border-right: 1px solid #dcdfe6;
}
.scroll-header .scroll-li {
  background-color: #F8F9FF;
}
.scroll-header .scroll-li > span {
  font-weight: bold; 
  border-top: none;
}
.scroll-content .scroll-ul:last-child .scroll-li {
  border-bottom: 1px solid #dcdfe6;
}
</style>