Switch

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

이 컴포넌트는 제어된 컴포넌트로, 사용자 동작을 반영하려면 onValueChange 콜백을 통해 value 프로퍼티를 업데이트해야 한다. value 프로퍼티가 업데이트되지 않으면, 컴포넌트는 사용자 동작의 예상 결과 대신 제공된 value 프로퍼티를 계속 렌더링한다.

---

참고 자료

Props

View Props

View Props를 상속한다.

disabled

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

타입	기본값
bool	false

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}

스위치의 값. true로 설정하면 스위치가 켜진다. 기본값은 false이다.

타입
bool