跳到主要内容

RefreshControl

该组件用于 ScrollView 或 ListView 内,实现下拉刷新功能。当 ScrollView 处于 scrollY: 0 时,向下滑动会触发 onRefresh 事件。

示例

备注

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


参考

属性

View Props

继承自 View Props


必填
refreshing

是否显示正在刷新状态。

类型
boolean

colors
Android

刷新指示器使用的颜色(至少一个)。

类型
颜色数组 (colors)

enabled
Android

是否启用下拉刷新功能。

类型默认值
booleantrue

onRefresh

开始刷新时调用的回调。

类型
function

progressBackgroundColor
Android

刷新指示器的背景色。

类型
颜色 (color)

progressViewOffset

刷新指示器顶部的偏移量。

类型默认值
number0

size
Android

刷新指示器的大小。

类型默认值
枚举('default', 'large')'default'

tintColor
iOS

刷新指示器颜色。

类型
颜色 (color)

title
iOS

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

类型
字符串

titleColor
iOS

刷新指示器标题的颜色。

类型
颜色 (color)