跳到主要内容
Version: 0.86

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