跳到主要内容

RefreshControl

此组件在 ScrollView 或 ListView 内部使用,以添加下拉刷新功能。当 ScrollView 位于 scrollY: 0 时,向下滑动会触发 onRefresh 事件。

示例

注意:refreshing 是一个受控 prop,这就是为什么需要在 onRefresh 函数中将其设置为 true,否则刷新指示器将立即停止。


参考

Props

View Props

继承自 View Props


必需
refreshing

视图是否应指示正在进行活动刷新。

类型
boolean

colors
Android

将用于绘制刷新指示器的颜色(至少一种)。

类型
colors 数组

enabled
Android

是否启用下拉刷新功能。

类型默认
booleantrue

onRefresh

当视图开始刷新时调用。

类型
function

progressBackgroundColor
Android

刷新指示器的背景颜色。

类型
color

progressViewOffset

进度视图顶部偏移量。

类型默认
number0

size
Android

刷新指示器的大小。

类型默认
enum('default', 'large')'default'

tintColor
iOS

刷新指示器的颜色。

类型
color

title
iOS

显示在刷新指示器下方的标题。

类型
string

titleColor
iOS

刷新指示器标题的颜色。

类型
color