as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
感谢您的访问。此页面目前仅提供英语版本。我们正在开发中文版本。谢谢您的理解。

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