跳到主要内容
Version: Next

RefreshControl

这一组件可以用在 ScrollView 或 FlatList 内部,为其添加下拉刷新的功能。当 ScrollView 处于竖直方向的起点位置(scrollY: 0),此时下拉会触发一个onRefresh事件。

示例

note

refreshing是一个受控属性,所以必须在onRefresh函数中设置为 true,否则 loading 指示器会立即停止。


参考

Props

View Props

继承了所有的 View Props.


必需
refreshing

视图是否应该在刷新时显示指示器。

类型
boolean

onRefresh

在视图开始刷新时调用。

类型
function

colors
Android

指定至少一种颜色用来绘制刷新指示器。

类型
array of colors

enabled
Android

指定是否要启用刷新指示器。

类型默认值
booleantrue

progressBackgroundColor
Android

指定刷新指示器的背景色。

类型
color

progressViewOffset

指定刷新指示器的垂直起始位置(top offset)。

类型默认值
number0

size
Android

指定刷新指示器的大小。

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

tintColor
iOS

指定刷新指示器的颜色。

类型
color

title
iOS

指定刷新指示器下显示的文字。

类型
string

titleColor
iOS

指定刷新指示器下显示的文字的颜色。

类型
color