这一组件用在 ScrollView 内部,作为 refreshControl 属性,为其添加下拉刷新的功能。
该组件分为五种展示状态:
PULLSTART:正在下拉,并未达到刷新所需高度,默认文本是『下拉可以刷新』
PULLCONTINUE:正在下拉,并且达到了刷新所需高度,默认文本是『松开即可刷新』
REFRESHING:正在刷新,此时用户已经松手,显示正在刷新状态,默认文本是『努力加载中』
SUCCESS:刷新结束,加载成功,默认文本是『加载成功』(1.3.0开始支持)
FAIL:刷新结束,加载失败,默认文本是『加载失败』(1.3.0开始支持)
当变成 REFRESHING 状态会触发 onRefresh 事件,此时,可以通过 ScrollView 的 stopRefreshing 方法来停止刷新。
辅助组件,作为 InfiniteListView
、ListView
和 ScrollView
组件的 refreshControl
属性,增加"下拉刷新"功能。
<InfiniteListView
refreshControl={<RefreshControl />}
/>
在 onRefresh
属性中传递数据请求函数,组件正在刷新状态时执行数据请求。请求完成后,调用父组件的 stopRefreshing
方法停止正在刷新状态。该方法接受的参数对象 config
决定了刷新后的状态。
config = {
animated: true, // 回到顶部是否需要动画
duration: 300, // 回到顶部的动画时间,默认300ms
result: true // 刷新结果状态。undefined:不显示刷新之后的状态;true:显示"加载成功";false:显示"加载失败"。
};
<InfiniteListView
refreshControl={<RefreshControl
onRefresh={() => this.onRefresh({ resulte: true })}
/>}
/>
RefreshControl的高度,下拉距离超过该距离时松手,会开始刷新
默认值: 35
正在下拉,未达到刷新高度时的文本
默认值: '下拉可以刷新'
正在下拉,达到刷新高度时的文本
默认值: '松开即可刷新'
PULLSTART和PULLCONTINUE时旋转的icon
默认值: '\uf07b'
正在刷新时的文本
默认值: '努力加载中'
REFRESHING时的旋转的icon文本
默认值: '\uf089'
加载成功时的文本
默认值: '加载成功'
加载成功时的icon文本
默认值: '\uf078'
加载失败时的文本
默认值: '加载失败'
加载失败时的icon文本
默认值: '\uf077'
切换到正在刷新状态时触发的事件
RefreshControl 容器样式
RefreshControl iconfont样式
RefreshControl 提示文字样式