From 9624b9a8cc9825a029be5429899140b23314cbf7 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan@buaa.edu.cn>
Date: Wed, 19 Sep 2018 13:47:06 +0800
Subject: [PATCH] [Doc] update list usage (#1826)

---
 packages/list/en-US.md |  6 +++++-
 packages/list/zh-CN.md | 13 +++++++++++--
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/packages/list/en-US.md b/packages/list/en-US.md
index 43b2ddcf5..40a87ccf8 100644
--- a/packages/list/en-US.md
+++ b/packages/list/en-US.md
@@ -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>
 ```
 
diff --git a/packages/list/zh-CN.md b/packages/list/zh-CN.md
index a455e0e74..81dfd0787 100644
--- a/packages/list/zh-CN.md
+++ b/packages/list/zh-CN.md
@@ -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` | `加载中...` |