Skip to main content
Version: Next

RefreshControl

이 컴포넌트는 ScrollView나 ListView 내부에서 사용되며, 당겨서 새로고침 기능을 추가한다. ScrollView가 scrollY: 0 위치에 있을 때, 아래로 스와이프하면 onRefresh 이벤트가 트리거된다.

예제​

참고: refreshing은 제어되는 프로퍼티(controlled prop)이므로, onRefresh 함수 내에서 이를 true로 설정해야 한다. 그렇지 않으면 새로고침 인디케이터가 즉시 멈춘다.

참조

Props​

View Props​

View Props를 상속한다.

필수
refreshing​

뷰가 활성화된 새로고침 상태를 나타내야 하는지 여부를 설정한다.

타입
boolean

colors
Android
​

새로고침 표시기를 그릴 때 사용할 색상(최소 하나 이상)을 지정한다.

타입
colors 배열

enabled
Android
​

풀 투 리프레시 기능이 활성화되었는지 여부를 나타낸다.

타입기본값
booleantrue

onRefresh​

뷰가 새로고침을 시작할 때 호출된다.

타입
function

progressBackgroundColor
Android
​

새로고침 표시기의 배경색을 지정한다.

타입
color

progressViewOffset​

프로그래스 뷰 상단 오프셋을 설정한다.

타입기본값
number0

size
Android
​

새로 고침 표시기의 크기를 지정한다.

타입기본값
enum('default', 'large')'default'

tintColor
iOS
​

새로고침 표시기의 색상을 지정한다.

타입
color

title
iOS
​

새로고침 표시기 아래에 보여지는 제목이다.

타입
string

titleColor
iOS
​

새로고침 표시기의 제목 색상을 설정한다.

타입
color