## List 列表 瀑布流滚动加载,用于控制长列表的展示 ### 使用指南 ``` javascript import { List } from 'vant'; Vue.use(List); ``` ### 代码演示 #### 基础用法 ```html ``` ```js export default { data() { return { list: [], loading: false, finished: false }; }, methods: { onLoad() { setTimeout(() => { for (let i = 0; i < 10; i++) { this.list.push(this.list.length + 1); } this.loading = false; if (this.list.length >= 40) { this.finished = true; } }, 500); } } } ``` ### API | 参数 | 说明 | 类型 | 默认值 | |-----------|-----------|-----------|-------------| | loading | 是否显示加载中提示,加载过程中不触发`load`事件 | `Boolean` | `false` | | finished | 是否已加载完成,加载完成后不再触发`load`事件 | `Boolean` | `false` | | offset | 滚动条与底部距离小于 offset 时触发`load`事件 | `Number` | `300` | | loading-text | 加载中提示文案 | `String` | `加载中...` | | immediate-check | 是否在初始化时立即执行滚动位置检查 | `Boolean` | `true` | ### Event | 事件名 | 说明 | 参数 | |-----------|-----------|-----------| | load | 滚动条与底部距离小于 offset 时触发 | - | ### 方法 通过 ref 可以获取到 list 实例并调用实例方法 | 方法名 | 参数 | 返回值 | 介绍 | |-----------|-----------|-----------|-------------| | check | - | - | 检查当前的滚动位置,若已滚动至底部,则会触发 load 事件 |