blackteay/vant
1
0
Fork 0
mirror of https://gitee.com/vant-contrib/vant.git synced 2025-04-23 18:00:27 +08:00
Code Issues Projects Releases Wiki Activity

[Doc] update list usage (#1826)

Browse Source
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
packages/list/en-US.md
View File

@ -18,7 +18,11 @@ Vue.use(List);
:finished="finished" :finished="finished"
@load="onLoad" @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> </van-list>
``` ```

13
packages/list/zh-CN.md
View File

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