@wanjunshijie/vue-seamless-scroll

vue-seamless-scroll

github: https://github.com/yelingkong/vue-seamless-scroll

Document for vue2

Install

# vue3
# yarn
yarn add @wanjunshijie/vue-seamless-scroll@latest --dev
# npm
npm i @wanjunshijie/vue-seamless-scroll@latest --save-dev

# vue2
# yarn
yarn add @wanjunshijie/vue-seamless-scroll@latest-v2 --dev
# npm
npm i @wanjunshijie/vue-seamless-scroll@latest-v2 --save-dev

Use

main.ts

import { createApp } from 'vue'
import App from './App.vue'
import { VueSeamlessScroll } from '@wanjunshijie/vue-seamless-scroll'

const app = createApp(App)
app.use(VueSeamlessScroll)
app.mount('#app')

env.d.ts

declare module '@wanjunshijie/vue-seamless-scroll'

App.vue

<template>
    <div class="box">
        <vue-seamless-scroll class="list" :data="data" direction="top" :steep="0.5" roller :distance="20">
            <div class="list-item" v-for="item, index in data" :key="index">{{ item.text }}</div>
        </vue-seamless-scroll>
    </div>
</template>

<script setup lang="ts">
import { ref } from 'vue'

let data = ref([
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
    { text: 'test' },
])
</script>

<style scoped>
.box {
    width: 100%;
    padding-top: 50px;
    display: flex;
    justify-content: center;
}

.list {
    height: 300px;
    overflow: hidden;
}

.list-item {
    width: 500px;
    height: 100px;
    margin-bottom: 20px;
    color: #000;
    font-size: 14px;
    background-color: aliceblue;
}
</style>

Api

Changelog

2026-09-20

• 新增移动端 / 平板手指拖动滚动支持（触屏拖拽）
  • 修复在移动端、平板等触屏设备上手指拖动列表无法滚动的问题
  • 在原有滚轮滚动基础上，补充 touchstart / touchmove / touchend 触摸事件：手指按下时暂停自动滚动，拖动时列表实时跟随手指移动，松手后恢复自动滚动
  • 拖动过程中对滚动范围做了边界限制，避免把列表拖出空白区域
  • 通过 touch-action: none 防止浏览器手势（页面滚动/缩放）劫持触摸事件

Tips

• 如没有显示请为嵌入的标签设置字体大小
• 当 direction 为 top 或 bottom 时，要为组件设置高度；当 direction 为 left 或 right 时，要为组件设置宽度
• reference: @david-j/vue-j-scroll