跳到主要内容

RefreshControl

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

示例

注意

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


参考

属性

View Props

继承自 View Props


必需
refreshing

视图是否应显示正在刷新的指示。

类型
布尔值

colors
Android

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

类型
颜色数组(colors

enabled
Android

是否启用“下拉刷新”功能。

类型默认
布尔值true

onRefresh

视图开始刷新时调用。

类型
函数

progressBackgroundColor
Android

刷新指示器的背景颜色。

类型
颜色

progressViewOffset

进度视图顶部偏移量。

类型默认
数字0

size
Android

刷新指示器的大小。

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

tintColor
iOS

刷新指示器的颜色。

类型
颜色

标题
iOS

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

类型
字符串

titleColor
iOS

刷新指示器标题的颜色。

类型
颜色