vant/docs/examples-docs/waterfall.md

Waterfall 瀑布流

使用指南

全局注册

Waterfall引入后就自动全局安装。如果需要，可以再次手动安装：

import Vue from 'vue';
import { Waterfall } from 'vant';

Waterfall.install(Vue);

局部注册

如果你只是想在某个组件中使用Waterfall，你可以在对应组件中注册Waterfall指令，这样只能在你注册的组件中使用Waterfall：

import { Waterfall } from 'vant';

export default {
  directives: {
    WaterfallLower: Waterfall('lower'),
    WaterfallUpper: Waterfall('upper')
  }
};

代码演示

<script> export default { data() { return { list: [1, 2, 3, 4, 5], loading: false, finished: false }; }, methods: { loadMore() { if (this.list.length >= 200) { this.finished = true; return; } this.loading = true; setTimeout(() => { let lastNumber = this.list[this.list.length - 1]; for (let i = 0; i < 5; i ++) { lastNumber += 1; this.list.push(lastNumber); } this.loading = false; }, 2000); } }, computed: { isWaterfallDisabled: function() { return this.loading || this.finished; } } }; </script> <style> .demo-waterfall { .waterfall { max-height: 360px; overflow: scroll; border-top: 1px solid #e5e5e5; } .waterfall-item { line-height: 50px; border-bottom: 1px solid #e5e5e5; background: #fff; } .page-desc { padding: 5px 0; line-height: 1.4; font-size: 14px; text-align: center; color: #666; } .van-loading { margin: 10px auto; } } </style>

基础用法

:::demo 基础用法

<p class="page-desc">当即将滚动到元素底部时，会自动加载更多</p>
<div class="waterfall">
  <div
    v-waterfall-lower="loadMore"
    waterfall-disabled="isWaterfallDisabled"
    waterfall-offset="400"
  >
    <div
      class="waterfall-item"
      v-for="(item, index) in list"
      :key="index"
      style="text-align: center;"
    >
      {{ item }}
    </div>
    <van-loading
      v-if="loading"
      :type="'circle'"
      :color="'black'"
    ></van-loading>
  </div>
</div>

:::

API

参数	说明	类型	默认值	可选值
v-waterfall-lower	滚动到底部, 触发执行的函数	function	-
v-waterfall-upper	滚动到顶部, 触发执行的函数	function	-
waterfall-disabled	在vue对象中表示是否禁止瀑布流触发的key值	string	-
waterfall-offset	触发瀑布流加载的阈值	number	300