当前位置：首页 > VUE

vue实现可滑动列表

2026-01-20 14:02:02VUE

实现可滑动列表的基本思路

在Vue中实现可滑动列表，通常需要结合CSS样式和JavaScript事件处理。常见的实现方式包括使用CSS的overflow属性、第三方库如better-scroll或vue-virtual-scroller，或原生HTML5的touch事件。

使用CSS实现基础滑动

通过CSS的overflow-x: auto或overflow-y: auto可以实现简单的滑动效果。适用于不需要复杂交互的场景。

<template>
  <div class="scroll-container">
    <div class="scroll-content">
      <!-- 列表内容 -->
      <div v-for="item in items" :key="item.id">{{ item.text }}</div>
    </div>
  </div>
</template>

<style>
.scroll-container {
  width: 100%;
  height: 300px;
  overflow-y: auto;
}
.scroll-content {
  height: 100%;
}
</style>

使用better-scroll库

better-scroll是一个流行的滑动解决方案，支持更复杂的交互效果，如惯性滑动、边界回弹等。

安装依赖：

npm install better-scroll

代码示例：

<template>
  <div ref="scrollContainer" class="scroll-container">
    <div class="scroll-content">
      <div v-for="item in items" :key="item.id">{{ item.text }}</div>
    </div>
  </div>
</template>

<script>
import BScroll from 'better-scroll';

export default {
  data() {
    return {
      items: [...], // 列表数据
      scroll: null
    };
  },
  mounted() {
    this.scroll = new BScroll(this.$refs.scrollContainer, {
      scrollY: true,
      click: true
    });
  },
  beforeDestroy() {
    this.scroll.destroy();
  }
};
</script>

<style>
.scroll-container {
  width: 100%;
  height: 300px;
  overflow: hidden;
}
.scroll-content {
  min-height: 100%;
}
</style>

使用vue-virtual-scroller优化长列表

对于超长列表，可以使用vue-virtual-scroller实现虚拟滚动，仅渲染可视区域内的内容以提升性能。

安装依赖：

npm install vue-virtual-scroller

代码示例：

<template>
  <RecycleScroller
    class="scroller"
    :items="items"
    :item-size="50"
    key-field="id"
    v-slot="{ item }"
  >
    <div>{{ item.text }}</div>
  </RecycleScroller>
</template>

<script>
import { RecycleScroller } from 'vue-virtual-scroller';
import 'vue-virtual-scroller/dist/vue-virtual-scroller.css';

export default {
  components: { RecycleScroller },
  data() {
    return {
      items: [...] // 列表数据
    };
  }
};
</script>

<style>
.scroller {
  height: 300px;
}
</style>

原生touch事件实现

如果需要完全自定义滑动逻辑，可以通过监听touchstart、touchmove和touchend事件实现。

<template>
  <div
    ref="scrollContainer"
    class="scroll-container"
    @touchstart="handleTouchStart"
    @touchmove="handleTouchMove"
    @touchend="handleTouchEnd"
  >
    <div class="scroll-content" :style="{ transform: `translateY(${offsetY}px)` }">
      <div v-for="item in items" :key="item.id">{{ item.text }}</div>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      items: [...], // 列表数据
      startY: 0,
      offsetY: 0,
      isDragging: false
    };
  },
  methods: {
    handleTouchStart(e) {
      this.startY = e.touches[0].clientY;
      this.isDragging = true;
    },
    handleTouchMove(e) {
      if (!this.isDragging) return;
      const deltaY = e.touches[0].clientY - this.startY;
      this.offsetY += deltaY;
      this.startY = e.touches[0].clientY;
    },
    handleTouchEnd() {
      this.isDragging = false;
    }
  }
};
</script>

<style>
.scroll-container {
  width: 100%;
  height: 300px;
  overflow: hidden;
  position: relative;
}
.scroll-content {
  transition: transform 0.3s ease;
}
</style>

横向滑动实现

横向滑动的实现方式与纵向类似，只需调整CSS和事件逻辑。

<template>
  <div ref="scrollContainer" class="horizontal-scroll">
    <div class="scroll-content">
      <div v-for="item in items" :key="item.id" class="item">{{ item.text }}</div>
    </div>
  </div>
</template>

<style>
.horizontal-scroll {
  width: 100%;
  overflow-x: auto;
  white-space: nowrap;
}
.scroll-content {
  display: inline-block;
}
.item {
  display: inline-block;
  width: 100px;
  height: 100px;
  margin-right: 10px;
}
</style>

以上方法可以根据实际需求选择，简单滑动使用CSS即可，复杂交互推荐使用第三方库，性能要求高的场景建议使用虚拟滚动。

vue实现可滑动列表