2xiao / vue3-waterfall-plugin

Vue 瀑布流组件

这是一款超轻量级的瀑布流组件，无需预设高度，支持PC和移动端。

在线演示地址

演示代码地址

安装

npm i vue-waterfall-plugin -S

使用

import Waterfall from "vue-waterfall-plugin";
<Waterfall
  :list="list"
  :gutter="10"
  :width="240"
  :breakpoints="{
    1200: { //当屏幕宽度小于等于1200
      rowPerView: 4,
    },
    800: { //当屏幕宽度小于等于800
      rowPerView: 3,
    },
    500: { //当屏幕宽度小于等于500
      rowPerView: 2,
    }
  }"
  animationEffect="fadeInUp" // 这里默认是fadeIn，其余的效果需要自己引入animation.css之后才能使用，也可以自己写animation
  backgroundColor="rgb(73, 74, 95)"
  ref="waterfall"
  >
  <template v-slot:item="props">
    <div class="card">
      <img :src="props.data.src" alt="" @load="$refs.waterfall.refresh">
      ...
    </div>
  </template>
</Waterfall>

参数

Name	Type	Default	Description
list	Array	[]	列表数据
gutter	Number	6	卡片之间的间隙
width	Number	200	卡片在PC上的宽度
breakpoints	Object	breakpoints	自定义行显示个数，主要用于对移动端的适配
backgroundColor	String	#fff	背景颜色
animationEffect	String	fadeIn	进入动画，默认只有fadeIn，支持引入使用animation.css的动画效果
animationDuration	String	1s	动画时间
animationDelay	String	0.3s	动画延迟

breakpoints: {
  1200: { //当屏幕宽度小于等于1200
    rowPerView: 4,
  },
  800: { //当屏幕宽度小于等于800
    rowPerView: 3,
  },
  500: { //当屏幕宽度小于等于500
    rowPerView: 2,
  }
}