当前位置：首页 > VUE

vue实现滚动列表

2026-02-18 20:29:53VUE

Vue 实现滚动列表的方法

使用 CSS 实现基础滚动

通过 CSS 的 overflow 属性可以快速实现滚动效果。将容器高度固定并设置 overflow-y: auto 即可启用垂直滚动条。

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

<style>
.scroll-container {
  height: 300px;
  overflow-y: auto;
  border: 1px solid #ddd;
}
.item {
  padding: 10px;
  border-bottom: 1px solid #eee;
}
</style>

使用第三方库实现高性能滚动

对于大数据量列表，推荐使用 vue-virtual-scroller 或 better-scroll 等库优化性能。这些库通过虚拟滚动技术减少 DOM 节点数量。

安装 vue-virtual-scroller：

npm install vue-virtual-scroller

示例代码：

<template>
  <RecycleScroller
    class="scroller"
    :items="items"
    :item-size="50"
    key-field="id"
  >
    <template v-slot="{ item }">
      <div class="item">
        {{ item.text }}
      </div>
    </template>
  </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: Array(1000).fill().map((_, i) => ({
        id: i,
        text: `Item ${i}`
      }))
    }
  }
}
</script>

<style>
.scroller {
  height: 300px;
}
.item {
  height: 50px;
  padding: 10px;
  border-bottom: 1px solid #eee;
}
</style>

实现无限滚动加载

结合 IntersectionObserver API 或滚动事件监听，可以实现无限滚动加载更多数据的效果。

<template>
  <div class="scroll-container" @scroll="handleScroll">
    <div v-for="item in items" :key="item.id" class="item">
      {{ item.text }}
    </div>
    <div v-if="loading" class="loader">Loading...</div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      items: [],
      page: 1,
      loading: false,
      hasMore: true
    }
  },
  methods: {
    async loadItems() {
      if (!this.hasMore || this.loading) return
      this.loading = true
      const newItems = await fetchItems(this.page)
      this.items = [...this.items, ...newItems]
      this.page++
      this.hasMore = newItems.length > 0
      this.loading = false
    },
    handleScroll(e) {
      const { scrollTop, clientHeight, scrollHeight } = e.target
      if (scrollHeight - (scrollTop + clientHeight) < 50) {
        this.loadItems()
      }
    }
  },
  mounted() {
    this.loadItems()
  }
}
</script>

实现平滑滚动动画

通过 CSS 的 scroll-behavior 属性或 JavaScript 的 scrollTo 方法可以实现平滑滚动效果。

CSS 方法：

.scroll-container {
  scroll-behavior: smooth;
}

JavaScript 方法：

vue实现滚动列表

methods: {
  scrollToTop() {
    const container = this.$el.querySelector('.scroll-container')
    container.scrollTo({
      top: 0,
      behavior: 'smooth'
    })
  }
}