Switch
사용자가 개별 옵션을 켜거나 끌 수 있는 컨트롤입니다. 일반적으로 설정을 제어하기 위해 사용됩니다.
구조도
- Root
- Track
- Handle
컴포넌트 미리보기
옵션
Selection
Switch는 Checkbox와 달리 selected, unselected 2개의 상태만 가질 수 있습니다.
Disabled
Disabled 상태는 Switch가 존재하지만 지금은 사용할 수 없는 상태를 나타냅니다. 이 옵션은 레이아웃 일관성을 유지하고 이후 상호작용이 가능할 수도 있음을 사용자에게 알려줍니다.
옵션 테이블
속성 | 값 | 기본값 | 설명 |
is disabled | true, false | false | true일 경우, Switch가 유저와 상호작용하지 않음 |
is readonly | true, false | false | true일 경우, isSelected를 변경할 수 없음 |
is required | true, false | false | true일 경우, isSelected = true가 필수임을 나타냄 |
is invalid | true, false | false | true일 경우, isSelected가 유효하지 않은 값임을 나타냄 |
상호작용
가이드라인
Checkbox vs Switch
Checkbox는 선택을 표현할 때 (예를 들어, 리스트에서 선택된 아이템을 표현할 때) 사용하고, Switch는 활성화/비활성화를 표현할 때 (예를 들어, 알림을 켜고 끌 때) 사용합니다. Checkbox는 Switch와 다르게 error 상태를 가질 수 있습니다.