RefreshControl 下拉刷新组件 >=v1.0.0

这一组件用在 ScrollView 内部,作为 refreshControl 属性,为其添加下拉刷新的功能。

该组件分为五种展示状态:

PULLSTART:正在下拉,并未达到刷新所需高度,默认文本是『下拉可以刷新』

PULLCONTINUE:正在下拉,并且达到了刷新所需高度,默认文本是『松开即可刷新』

REFRESHING:正在刷新,此时用户已经松手,显示正在刷新状态,默认文本是『努力加载中』

SUCCESS:刷新结束,加载成功,默认文本是『加载成功』(1.3.0开始支持)

FAIL:刷新结束,加载失败,默认文本是『加载失败』(1.3.0开始支持)

当变成 REFRESHING 状态会触发 onRefresh 事件,此时,可以通过 ScrollViewstopRefreshing 方法来停止刷新。

RefreshControl

使用说明

辅助组件

辅助组件,作为 InfiniteListViewListViewScrollView 组件的 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 })}
    />}
/>

属性

height =={ number }==

RefreshControl的高度,下拉距离超过该距离时松手,会开始刷新

默认值: 35

pullStartContent =={ string }==

正在下拉,未达到刷新高度时的文本

默认值: '下拉可以刷新'

pullContinueContent =={ string }==

正在下拉,达到刷新高度时的文本

默认值: '松开即可刷新'

pullIcon =={ string }=={.type} >=1.3.0

PULLSTART和PULLCONTINUE时旋转的icon

默认值: '\uf07b'

refreshingContent =={ string }==

正在刷新时的文本

默认值: '努力加载中'

refreshingIcon =={ string }=={.type} >=1.3.0

REFRESHING时的旋转的icon文本

默认值: '\uf089'

successContent =={ string }=={.type} >= 1.3.0

加载成功时的文本

默认值: '加载成功'

successIcon =={ string }=={.type} >=1.3.0

加载成功时的icon文本

默认值: '\uf078'

failContent =={ string }=={.type} >= 1.3.0

加载失败时的文本

默认值: '加载失败'

failIcon =={ string }=={.type} >=1.3.0

加载失败时的icon文本

默认值: '\uf077'

onRefresh =={ function }==

切换到正在刷新状态时触发的事件

style =={ View.propTypes.style }==

RefreshControl 容器样式

iconStyle =={ Text.propTypes.style }==

RefreshControl iconfont样式

textStyle { Text.propTypes.style }

RefreshControl 提示文字样式