Skip to main content
Version: 0.64

RefreshControl

This component is used inside a ScrollView or ListView to add pull to refresh functionality. When the ScrollView is at scrollY: 0, swiping down triggers an onRefresh event.

Exampleโ€‹

Note: refreshing is a controlled prop, this is why it needs to be set to true in the onRefresh function otherwise the refresh indicator will stop immediately.


Reference

Propsโ€‹

View Propsโ€‹

Inherits View Props.


Required
refreshingโ€‹

Whether the view should be indicating an active refresh.

Type
boolean

colors
Android
โ€‹

The colors (at least one) that will be used to draw the refresh indicator.

Type
array of colors

enabled
Android
โ€‹

Whether the pull to refresh functionality is enabled.

TypeDefault
booleantrue

onRefreshโ€‹

Called when the view starts refreshing.

Type
function

progressBackgroundColor
Android
โ€‹

The background color of the refresh indicator.

Type
color

progressViewOffset
Android
โ€‹

Progress view top offset.

TypeDefault
number0

size
Android
โ€‹

Size of the refresh indicator.

TypeDefault
RefreshControl.SIZERefreshLayoutConsts.SIZE.DEFAULT

tintColor
iOS
โ€‹

The color of the refresh indicator.

Type
color

title
iOS
โ€‹

The title displayed under the refresh indicator.

Type
string

titleColor
iOS
โ€‹

The color of the refresh indicator title.

Type
color

Type Definitionsโ€‹

RefreshLayoutConsts.SIZEโ€‹

The SwipeRefreshLayout Android component constants. The actual component size may vary between devices. You can read more about the native component in the Android documentation.

Type
enum

Constants:

NameTypeValueDescription
DEFAULTint1Default RefreshControl size
LARGEint0Large RefreshControl size