Skip to main content
Join us for React Conf on Oct 7-8. Learn more.
This is unreleased documentation for React Native Next version.
For up-to-date documentation, see the latest version (0.81).
Version: Next

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​

Progress view top offset.

TypeDefault
number0

size
Android
​

Size of the refresh indicator.

TypeDefault
enum('default', 'large')'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

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /