토글 스위치
토글은 상호 배타적인 두 가지 상태를 전환하는 데 사용되는 요소이다.
사용 지침
알림 수신 여부·다크 모드처럼 변경 즉시 효과가 적용되는 설정에 사용하고, 변경에 별도의 "저장" 액션이 필요하다면 체크박스를 우선 고려합니다.
예제
기본
선택됨
비활성화
비활성화 선택됨
중간 크기
큰 크기
제어 상태
현재 상태: 꺼짐
전체 변형
MediumLarge
속성
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| aria-label | string | — | Defines a string value that labels the current element. @see aria-labelledby. |
| checked | boolean | — | — |
| className | string | — | — |
| disabled | boolean | — | — |
| id | string | — | — |
| label | string | — | — |
| onCheckedChange | ((checked: boolean) => void) | — | — |
| onClick | MouseEventHandler<HTMLSpanElement> | — | — |
| size | enum | medium | — |
| style | CSSProperties | — | — |
| tabIndex | number | — | — |