Skip to main content

Switch

불리언 입력을 렌더링한다.

이 컴포넌트는 사용자 동작을 반영하기 위해 value prop을 업데이트하는 onValueChange 콜백이 필요한 제어 컴포넌트다. value prop이 업데이트되지 않으면, 컴포넌트는 사용자 동작의 결과가 아닌 제공된 value prop을 계속 렌더링한다.

참조

Props​

View Props​

View Props를 상속한다.

disabled​

이 값이 true이면 사용자가 스위치를 토글할 수 없다.

타입기본값
boolfalse

ios_backgroundColor
iOS
​

iOS에서 배경색을 커스텀으로 설정할 수 있다. 이 배경색은 스위치 값이 false일 때나 스위치가 비활성화된 경우(스위치가 반투명일 때)에 볼 수 있다.

타입
color

onChange​

사용자가 스위치 값을 변경하려고 할 때 호출된다. 변경 이벤트를 인자로 받는다. 새로운 값만 받고 싶다면 onValueChange를 대신 사용한다.

타입
function

onValueChange​

사용자가 스위치 값을 변경하려고 할 때 호출된다. 새로운 값을 인자로 받는다. 이벤트를 받고 싶다면 onChange를 사용한다.

타입
function

thumbColor​

스위치 그립의 전경색을 지정한다. iOS에서 이 값을 설정하면 스위치 그립의 그림자가 사라진다.

타입
color

trackColor​

스위치 트랙의 커스텀 색상을 설정한다.

iOS: 스위치 값이 false일 때, 트랙이 테두리 안쪽으로 축소된다. 축소된 트랙에 의해 노출된 배경색을 변경하려면 ios_backgroundColor를 사용한다.

타입
object: {false: color, true: color}

value​

스위치의 값을 나타낸다. true일 경우 스위치가 켜진 상태가 된다. 기본값은 false이다.

타입
bool