본문으로 건너뛰기
선택

스위치

즉시 적용되는 on/off 설정을 바꾸는 토글 스위치다. 필터나 액션 토글은 ToggleButton 을 쓰고, 설정값 자체를 켜고 끄는 경우 Switch 를 쓴다.

상태

off
on
disabled

활용 방법

설정

label 과 description 으로 설정의 영향을 설명한다.

Preview
tsx
<Switch label="이메일 알림" description="중요 상태 변경을 이메일로 받습니다." defaultChecked />

사용 지침

  • · 변경 즉시 적용되는 설정에 쓴다.
  • · 저장 버튼이 필요한 폼 값은 Checkbox 또는 Select 를 고려한다.

속성

이름타입기본값설명
labelReactNode-스위치 라벨
descriptionReactNode-보조 설명
...propsInputHTMLAttributes-checked·defaultChecked·onChange·disabled 등