Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support

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

Copied to clipboard.


import React from 'react';
import {RefreshControl, ScrollView, StyleSheet, Text} from 'react-native';
import {SafeAreaView, SafeAreaProvider} from 'react-native-safe-area-context';

const App = () => {
  const [refreshing, setRefreshing] = React.useState(false);

  const onRefresh = React.useCallback(() => {
    setRefreshing(true);
    setTimeout(() => {
      setRefreshing(false);
    }, 2000);
  }, []);

  return (
    <SafeAreaProvider>
      <SafeAreaView style={styles.container}>
        <ScrollView
          contentContainerStyle={styles.scrollView}
          refreshControl={
            <RefreshControl refreshing={refreshing} onRefresh={onRefresh} />
          }>
          <Text>Pull down to see RefreshControl indicator</Text>
        </ScrollView>
      </SafeAreaView>
    </SafeAreaProvider>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
  },
  scrollView: {
    flex: 1,
    backgroundColor: 'pink',
    alignItems: 'center',
    justifyContent: 'center',
  },
});

export default App;


Reference

Props

View Props

Inherits View Props.


Requiredrefreshing Android iOS

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.

Type Default
boolean true

onRefresh Android iOS

Called when the view starts refreshing.

Type
function

progressBackgroundColor Android

The background color of the refresh indicator.

Type
color

progressViewOffset Android iOS

Progress view top offset.

Type Default
number 0

size Android

Size of the refresh indicator.

Type Default
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

Last updated: May 13, 2026