LoadMore 加载更多
- 此组件一般用于标识页面底部加载数据时的状态,共有三种状态:
- 加载前,显示"加载更多",加入点击可选,是因为数据不够一页时,无法触发页面的onReachBottom生命周期
- 加载中,显示"正在加载...",多种动画可选
- 加载后,如果还有数据,回到"加载前"状态,否则加载结束,显示"没有更多了"
平台差异说明
| App(vue) | App(nvue) | H5 | 小程序 |
|---|
| √ | × | √ | √ |
基本使用
通过status设置组件的状态,加载前值为loadmore,加载中为loading,没有数据为nomore。
<m-loadmore
status="loadmore"
line
/>
手动触发加载更多
有时候可能会因为网络,或者数据不满一页的原因,导致无法上拉触发onReachBottom生命周期,这时候(需status为loadmore状态),用户点击组件,就会触发loadmore事件,可以在回调中,进行状态的控制和数据的加载,同时也可以修改loadText的loadmore为"上拉或点击加载更多"进行更加人性化的提示。
API
Props
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|
| status | 组件状态 | String | loadmore | loading | nomore |
| bgColor | 组件背景颜色,在页面是非白色时会用到(默认为transparent) | String | transparent | - |
| icon | 加载中时是否显示图标 | Boolean | true | false |
| fontSize | 字体大小,单位px | Number | String | 14 | - |
| iconSize | 图标大小,单位px | Number | String | 17 | - |
| color | 字体颜色 | String | color['m-content-color'] | - |
| loadingIcon | 加载中状态的图标 | String | spinner | 查看loadingIconopen in new window |
| loadmoreText | 加载前的提示语 | String | 加载更多 | - |
| loadingText | 加载中提示语 | String | 正在加载... | - |
| nomoreText | 没有更多的提示语 | String | 没有更多了 | - |
| isDot | status为nomore时,内容显示为一个"●" | Boolean | false | true |
| iconColor | 加载中的动画图标的颜色 | String | #b7b7b7 | - |
| marginTop | 与前一个元素的距离,单位px | Number | String | 10 | - |
| marginBottom | 与后一个元素的距离,单位px | Number | String | 10 | - |
| height | 高度 | Number | String | auto | - |
| line | 是否显示左边分割线 | Boolean | false | true |
Event
| 事件名 | 说明 | 回调参数 |
|---|
| loadmore | status为loadmore时,点击组件会发出此事件 | - |