[new feature] List 考虑错误情况，增加 error-text 属性 #2567 (#2568)

packages/list/zh-CN.md

@@ -12,13 +12,15 @@ Vue.use(List);
 
 #### 基础用法
 
-List 组件通过`loading`和`finished`两个变量控制加载状态，当组件滚动到底部时，会触发`load`事件并将`loading`设置成`true`。此时可以发起异步操作并更新数据，数据更新完毕后，将`loading`设置成`false`即可。若数据已全部加载完毕，则直接将`finished`设置成`true`即可。
+List 组件通过`loading`、`finished`和`error`三个变量控制加载状态，当组件滚动到底部时，会触发`load`事件并将`loading`设置成`true`。此时可以发起异步操作并更新数据，数据更新完毕后，将`loading`设置成`false`即可。若数据已全部加载完毕，则直接将`finished`设置成`true`即可。若数据加载失败，将`error`设置成`true`，出现错误提示，用户点击错误提示，重新请求。
 
 ```html
 <van-list
   v-model="loading"
   :finished="finished"
+  :error.sync="error"
   finished-text="没有更多了"
+  error-text="请求失败，点击重新加载..."
   @load="onLoad"
 >
   <van-cell
@@ -35,7 +37,8 @@ export default {
     return {
       list: [],
       loading: false,
-      finished: false
+      finished: false,
+      error: false
     };
   },
 
@@ -49,6 +52,9 @@ export default {
         // 加载状态结束
         this.loading = false;
 
+        // 当请求错误时
+        // this.error = true;
+
         // 数据全部加载完成
         if (this.list.length >= 40) {
           this.finished = true;
@@ -65,9 +71,11 @@ export default {
 |------|------|------|------|------|
 | loading | 是否处于加载状态，加载过程中不触发`load`事件 | `Boolean` | `false` | - |
 | finished | 是否已加载完成，加载完成后不再触发`load`事件 | `Boolean` | `false` | - |
+| error | 是否加载失败，加载失败后只能通过点击错误提示重新加载`load`事件，必须使用`sync`修饰符 | `Boolean` | `false` | - |
 | offset | 滚动条与底部距离小于 offset 时触发`load`事件 | `Number` | `300` | - |
 | loading-text | 加载过程中的提示文案 | `String` | `加载中...` | 1.1.1 |
 | finished-text | 加载完成后的提示文案 | `String` | - | 1.4.7 |
+| error-text | 加载失败后的提示文案 | `String` | - | - |
 | immediate-check | 是否在初始化时立即执行滚动位置检查 | `Boolean` | `true` | - |
 
 ### Event