Skip to main content
Version: Next

모든 플랫폼에서 잘 렌더링되는 기본 버튼 컴포넌트이다. 최소한의 커스텀 기능을 지원한다.

이 버튼이 앱에 적합하지 않다면, Pressable을 사용해 직접 버튼을 만들 수 있다. 참고를 위해 Button 컴포넌트의 소스 코드를 살펴보는 것도 좋다.

tsx
<Button
  onPress={onPressLearnMore}
  title="Learn More"
  color="#841584"
  accessibilityLabel="Learn more about this purple button"
/>

참고

Props​

필수
onPress​

사용자가 버튼을 탭할 때 호출될 핸들러.

타입
({nativeEvent: PressEvent})

필수
title​

버튼 안에 표시할 텍스트. 안드로이드에서는 주어진 제목이 대문자로 변환된다.

타입
string

accessibilityLabel​

시각 장애인 접근성 기능을 위한 표시 텍스트.

타입
string

accessibilityLanguage
iOS
​

사용자가 엘리먼트와 상호작용할 때 스크린 리더가 사용해야 할 언어를 지정하는 값이다. 이 값은 BCP 47 사양을 따라야 한다.

더 자세한 정보는 iOS accessibilityLanguage 문서를 참고한다.

타입
string

accessibilityActions​

접근성 액션은 보조 기술이 컴포넌트의 동작을 프로그래밍 방식으로 실행할 수 있도록 한다. accessibilityActions 속성은 액션 객체들의 리스트를 포함해야 한다. 각 액션 객체는 필드 이름과 라벨을 포함해야 한다.

자세한 내용은 접근성 가이드를 참조한다.

타입필수 여부
배열아니오

onAccessibilityAction​

사용자가 접근성 동작을 수행할 때 호출된다. 이 함수의 유일한 인자는 수행할 동작의 이름을 포함하는 이벤트 객체이다.

자세한 내용은 접근성 가이드를 참고한다.

타입필수 여부
function아니오

color​

텍스트 색상(iOS) 또는 버튼 배경 색상(Android)을 설정한다.

타입기본값
color '#2196F3'
Android
'#007AFF'
iOS

disabled​

이 값이 true로 설정되면, 해당 컴포넌트와의 모든 상호작용이 비활성화된다.

타입기본값
boolfalse

hasTVPreferredFocus
TV
​

TV에서 우선적으로 포커스를 받을지 여부를 설정한다.

타입기본값
boolfalse

nextFocusDown
Android
TV
​

사용자가 아래로 네비게이션할 때 다음으로 포커스를 받을 뷰를 지정한다. 자세한 내용은 Android 문서를 참고한다.

타입
number

nextFocusForward
Android
TV
​

사용자가 앞으로 이동할 때 포커스를 받을 다음 뷰를 지정한다. 자세한 내용은 Android 공식 문서를 참고한다.

타입
number

nextFocusLeft
Android
TV
​

사용자가 왼쪽으로 네비게이션할 때 포커스를 받을 다음 뷰를 지정한다. 자세한 내용은 Android 문서를 참고한다.

타입
number

nextFocusRight
Android
TV
​

사용자가 오른쪽으로 이동할 때 포커스를 받을 다음 뷰를 지정한다. 자세한 내용은 Android 문서를 참고한다.

타입
number

nextFocusUp
Android
TV
​

사용자가 위로 이동할 때 다음으로 포커스를 받을 뷰를 지정한다. 자세한 내용은 Android 문서를 참고한다.

타입
number

testID​

이 뷰를 엔드투엔드 테스트에서 찾는 데 사용한다.

타입
string

touchSoundDisabled
Android
​

true로 설정하면 터치 시 시스템 사운드를 재생하지 않는다.

타입기본값
booleanfalse