토글 스위치

토글은 상호 배타적인 두 가지 상태를 전환하는 데 사용되는 요소이다.

토글은 상호 배타적인 두 가지 상태를 전환하는 데 사용되는 요소이다.

사용 지침

알림 수신 여부·다크 모드처럼 변경 즉시 효과가 적용되는 설정에 사용하고, 변경에 별도의 "저장" 액션이 필요하다면 체크박스를 우선 고려합니다.

예제

Default

examples/toggle-switch/ToggleSwitchDefault.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchDefault() {

Checked

examples/toggle-switch/ToggleSwitchChecked.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchChecked() {

Disabled

examples/toggle-switch/ToggleSwitchDisabled.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchDisabled() {

Disabled Checked

examples/toggle-switch/ToggleSwitchDisabledChecked.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchDisabledChecked() {

Medium

examples/toggle-switch/ToggleSwitchMedium.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchMedium() {

Large

examples/toggle-switch/ToggleSwitchLarge.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchLarge() {

Controlled

현재 상태: 꺼짐

examples/toggle-switch/ToggleSwitchControlled.tsx
"use client"

import * as React from "react"

All Variants

MediumLarge
examples/toggle-switch/ToggleSwitchAllVariants.tsx
import { ToggleSwitch } from "@/components/ui/dynamic/toggle-switch"

export default function ToggleSwitchAllVariants() {

속성

이름타입기본값설명
aria-labelstringDefines a string value that labels the current element. @see aria-labelledby.
checkedboolean
classNamestring
disabledboolean
idstring
labelstring
onCheckedChange((checked: boolean) => void)
onClickMouseEventHandler<HTMLSpanElement>
sizeenummedium
styleCSSProperties
tabIndexnumber