跳到主要内容

RefreshControl

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

示例

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


参考

属性

View 属性

继承自 View 属性


必需
refreshing

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

类型
布尔值

colors
Android

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

类型
颜色数组

enabled
Android

是否启用下拉刷新功能。

类型默认值
布尔值true

onRefresh

当视图开始刷新时调用。

类型
函数

progressBackgroundColor
Android

刷新指示器的背景颜色。

类型
颜色

progressViewOffset

进度视图顶部偏移量。

类型默认值
数字0

size
Android

刷新指示器的大小。

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

tintColor
iOS

刷新指示器的颜色。

类型
颜色

title
iOS

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

类型
字符串

titleColor
iOS

刷新指示器标题的颜色。

类型
颜色