[Doc] update list usage (#1826)

This commit is contained in:
neverland 2018-09-19 13:47:06 +08:00 committed by GitHub
parent d1cb1bc58e
commit 9624b9a8cc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 16 additions and 3 deletions

View File

@ -18,7 +18,11 @@ Vue.use(List);
:finished="finished"
@load="onLoad"
>
<van-cell v-for="item in list" :key="item" :title="item + ''" />
<van-cell
v-for="item in list"
:key="item"
:title="item"
/>
</van-list>
```

View File

@ -12,13 +12,19 @@ Vue.use(List);
#### 基础用法
List 组件通过`loading``finished`两个变量控制加载状态,当组件滚动到底部时,会触发`load`事件并将`loading`设置成`true`。此时可以发起异步操作并更新数据,数据更新完毕后,将`loading`设置成`false`即可。若数据已全部加载完毕,则直接将`finished`设置成`true`即可。
```html
<van-list
v-model="loading"
:finished="finished"
@load="onLoad"
>
<van-cell v-for="item in list" :key="item" :title="item + ''" />
<van-cell
v-for="item in list"
:key="item"
:title="item"
/>
</van-list>
```
@ -34,12 +40,15 @@ export default {
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;
}
@ -53,7 +62,7 @@ export default {
| 参数 | 说明 | 类型 | 默认值 |
|-----------|-----------|-----------|-------------|
| loading | 是否显示加载中提示,加载过程中不触发`load`事件 | `Boolean` | `false` |
| loading | 是否处于加载状态,加载过程中不触发`load`事件 | `Boolean` | `false` |
| finished | 是否已加载完成,加载完成后不再触发`load`事件 | `Boolean` | `false` |
| offset | 滚动条与底部距离小于 offset 时触发`load`事件 | `Number` | `300` |
| loading-text | 加载中提示文案 | `String` | `加载中...` |