Skip to main content

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

이 버튼이 앱에 적합하지 않다면, 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 속성은 액션 객체의 리스트를 포함해야 한다. 각 액션 객체는 name과 label 필드를 포함해야 한다.

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

타입필수 여부
배열아니오

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