토글 스위치
토글은 상호 배타적인 두 가지 상태를 전환하는 데 사용되는 요소이다.
토글은 상호 배타적인 두 가지 상태를 전환하는 데 사용되는 요소이다.
사용 지침
알림 수신 여부·다크 모드처럼 변경 즉시 효과가 적용되는 설정에 사용하고, 변경에 별도의 "저장" 액션이 필요하다면 체크박스를 우선 고려합니다.
예제
Default
Checked
Disabled
Disabled Checked
Medium
Large
Controlled
현재 상태: 꺼짐
All Variants
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 | — | — |