/vue-waterfall2

vue-waterfall2 waterfall adaption plugin for vue , so easy!

Primary LanguageVue

vue-waterfall2

  • 1.不需知道元素宽高，可宽高自适应
  • 2.自定义程度高,布局未采用绝对定位
  • 3.使用极为简便,适用于PC/ios/android
  • 4.提供Event:loadmore (pc/android端滑动到底部触发，ios端需要上拉触发)
  • 5.兼容性好,兼容ES5

有问题欢迎提issues、suggestions

Demo

Demo

GITHUB

npm i 
npm run dev

Installation

 npm i vue-waterfall2@latest --save

Usage

注意:

  • 1. gutterWidth需要与width一起使用才会生效，否则会进行自适应宽度(使用rem布局时，需先计算出自适应后的宽度再传值)
  • 2.使用了waterfall的父组件 style 不允许使用scoped,否则样式会有问题
main.js
import waterfall from 'vue-waterfall2'
Vue.use(waterfall)
app.vue(此组件 style不使用 scoped)
<template>
  <div class="container-water-fall">
    <div><button  @click="loadmore">loadmore</button> <button @click="mix">mix</button> <button @click="switchCol('5')">5列</button> <button @click="switchCol('8')">8列</button> <button @click="switchCol('10')">10列</button> </div>

    <waterfall :col='col' :width="itemWidth" :gutterWidth="gutterWidth"  :data="data"  @loadmore="loadmore"  @scroll="scroll"  >
      <template >
        <div class="cell-item" v-for="(item,index) in data">
          <img :src="item.img"  />
          <div class="item-body">
              <div class="item-desc">{{item.title}}</div>
              <div class="item-footer">
                  <div class="avatar" :style="{backgroundImage : `url(${item.avatar})` }"></div>
                  <div class="name">{{item.user}}</div>
                  <div class="like" :class="item.liked?'active':''" >
                      <i ></i>
                      <div class="like-total">{{item.liked}}</div>  
                  </div>
              </div>
          </div>
        </div>
      </template>
    </waterfall>
    
  </div>
</template>


/*
  注意:
  1.gutterWidth需要与width一起使用才会生效，否则会进行自适应宽度(使用rem布局时，需先计算出自适应后的宽度再传值)
  2.使用了waterfall的组件不允许使用scoped,否则样式会有问题
*/

import Vue from 'vue'
	export default{
	    data(){
	      return{
	        data:[],
	        col:5,
	      }
	    },
	    computed:{
	      itemWidth(){  
	        return (138*0.5*(document.documentElement.clientWidth/375))  #rem布局 计算宽度
	      },
	      gutterWidth(){
	        return (9*0.5*(document.documentElement.clientWidth/375))	#rem布局 计算x轴方向margin(y轴方向的margin自定义在css中即可)
	      }
	    },
	    methods:{
              scroll(scrollData){
                console.log(scrollData)
              },
	      mix(){
	        this.$waterfall.mix()
	      },
	      switchCol(col){
	        this.col = col
	        console.log(this.col)
	      },
	      loadmore(index){
	        this.data = this.data.concat(this.data)
	      }
	    }
	}

Props

Name Default Type Desc
col 2 Number the number of column
width null Number the value of width
gutterWidth 10 Number the value of margin
data [] Array data

Events

Name Data Desc
loadmore null Scroll to the bottom to trigger on PC / pull up to trigger on Mobile
scroll obj Scroll to trigger and get the infomation of scroll

$waterfall API

this.$waterfall.resize()   
this.$waterfall.mix()