当前位置：首页 > VUE

vue实现瀑布图

2026-01-18 06:31:56VUE

Vue 实现瀑布流布局

瀑布流布局是一种常见的网页布局方式，适用于图片、卡片等内容的展示。以下是几种在 Vue 中实现瀑布流布局的方法。

使用 CSS 多列布局

CSS 的多列布局（column-count 和 column-gap）可以快速实现简单的瀑布流效果。这种方法适合内容高度相近的场景。

<template>
  <div class="waterfall-container">
    <div v-for="(item, index) in items" :key="index" class="waterfall-item">
      <img :src="item.image" :alt="item.title" />
      <p>{{ item.title }}</p>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      items: [
        { image: 'image1.jpg', title: 'Item 1' },
        { image: 'image2.jpg', title: 'Item 2' },
        // 更多数据...
      ]
    };
  }
};
</script>

<style>
.waterfall-container {
  column-count: 3;
  column-gap: 15px;
}
.waterfall-item {
  break-inside: avoid;
  margin-bottom: 15px;
}
</style>

使用 CSS Flexbox 或 Grid

Flexbox 或 Grid 布局需要结合 JavaScript 动态计算高度来实现瀑布流效果。以下是一个使用 Flexbox 的示例：

<template>
  <div class="waterfall-container">
    <div v-for="(item, index) in items" :key="index" class="waterfall-item">
      <img :src="item.image" :alt="item.title" />
      <p>{{ item.title }}</p>
    </div>
  </div>
</template>

<style>
.waterfall-container {
  display: flex;
  flex-wrap: wrap;
  gap: 15px;
}
.waterfall-item {
  flex: 1 0 calc(33.333% - 15px);
}
</style>

使用第三方库

如果需要更复杂的瀑布流效果，可以使用以下第三方库：

Masonry：一个流行的瀑布流布局库，支持动态加载和响应式布局。
Vue-Waterfall：专为 Vue 设计的瀑布流组件，使用简单且功能强大。

安装 Vue-Waterfall：

npm install vue-waterfall --save

使用示例：

<template>
  <vue-waterfall :list="items" :gutter="15" :cols="3">
    <template v-slot:item="{ item }">
      <img :src="item.image" :alt="item.title" />
      <p>{{ item.title }}</p>
    </template>
  </vue-waterfall>
</template>

<script>
import VueWaterfall from 'vue-waterfall';
export default {
  components: { VueWaterfall },
  data() {
    return {
      items: [
        { image: 'image1.jpg', title: 'Item 1' },
        { image: 'image2.jpg', title: 'Item 2' },
        // 更多数据...
      ]
    };
  }
};
</script>

动态加载数据

结合异步加载数据，可以实现无限滚动的瀑布流效果。以下是一个示例：

<template>
  <div class="waterfall-container" ref="container">
    <div v-for="(item, index) in items" :key="index" class="waterfall-item">
      <img :src="item.image" :alt="item.title" />
      <p>{{ item.title }}</p>
    </div>
    <div v-if="loading" class="loading">Loading...</div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      items: [],
      loading: false,
      page: 1
    };
  },
  mounted() {
    this.loadItems();
    window.addEventListener('scroll', this.handleScroll);
  },
  methods: {
    async loadItems() {
      this.loading = true;
      const newItems = await fetch(`/api/items?page=${this.page}`).then(res => res.json());
      this.items = [...this.items, ...newItems];
      this.page++;
      this.loading = false;
    },
    handleScroll() {
      const { scrollTop, clientHeight, scrollHeight } = document.documentElement;
      if (scrollTop + clientHeight >= scrollHeight - 100 && !this.loading) {
        this.loadItems();
      }
    }
  },
  beforeDestroy() {
    window.removeEventListener('scroll', this.handleScroll);
  }
};
</script>

响应式设计

为了适应不同屏幕尺寸，可以通过媒体查询动态调整列数：

.waterfall-container {
  column-count: 1;
  column-gap: 15px;
}
@media (min-width: 600px) {
  .waterfall-container {
    column-count: 2;
  }
}
@media (min-width: 900px) {
  .waterfall-container {
    column-count: 3;
  }
}

以上方法可以根据实际需求选择，CSS 多列布局适合简单场景，而第三方库和动态加载适合更复杂的需求。

vue实现瀑布图