Get StartedFoundationsComponentsPatternsRulesDevelopAI & ToolsUpdates

Switch

특정 설정 및 상태를 즉시 켜거나 끌 수 있도록 하는 컴포넌트예요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/switch.json

Anatomy

Switch는 Switchmark와 Label로 구성돼요. Switchmark는 개별 컴포넌트(Switchmark)로 제공되어서 자유롭게 조합해서 사용할 수 있어요.

Switchmark는 Thumb과 Track으로 이뤄져 있어요.

요소컴포넌트설명
RootSwitch (label)Switchmark와 Label을 포함한 전체 영역이 누르는 영역이에요.
TrackSwitchmark켜짐/꺼짐 상태에 따라 색이 바뀌는 바탕이에요. 눌리면 Thumb과 함께 살짝 줄어들어요.
ThumbSwitchmark 안쪽선택되면 오른쪽으로 이동하며 커져요.
Labellabel propSwitchmark 옆에 보여주는 텍스트예요.

Properties

Size

Switch는 높이값에 따라 16, 24, 32로 제공돼요. 각 크기에 시각적으로 가장 잘 어울리는 텍스트 레이블 스타일(32: T5, 24: T4, 16: T3)이 함께 적용돼요.

Tone

Switch는 Brand, Neutral 두 가지 Tone을 가져요. 디자인 가이드에서는 Neutral Tone을 기본으로 사용하는 것을 권장해요.

State

Switch는 선택(Selected), 미선택(Unselected) 상태를 가지며, 각각의 상태는 사용자의 상호작용에 따라 활성화(Enabled), 비활성화(Disabled) 상태로 조합되어 표현돼요.

Long Label

라벨이 길어지면 여러 줄로 줄바꿈되고, Switchmark는 첫 줄에 맞춰 정렬돼요.

Switchmark

Switchmark 는 라벨 없이 쓰는 스위치 표시예요. List처럼 다른 요소와 조합할 때 사용해요.

Guidelines

Switch touch target

Switch는 Switchmark와 Label을 포함한 영역이 Target으로 동작해요. 16 사이즈는 최소 터치 영역을 보장하기 위해 24 높이값을 가지고 있어요.

List처럼 Switch를 조합해서 사용하는 경우 전체 Row가 Target 영역이 되어야 해요.

Switchmark는 다른 요소와 조합하여 사용하도록 설계되었기 때문에 요소 크기 이상의 터치 영역을 별도로 가지고 있지 않아요.

상태를 즉시 활성화할 때 사용하기

Switch는 토글 시 즉각적인 결과가 나타나요. 마지막 버튼을 누를 때까지 결과가 나타나지 않는 경우에는 Checkbox를 사용해요.

Do· 제출 전 확인은 Checkbox

즉각적인 결과가 나타나지 않는 경우 Checkbox를 사용해요.

Don't· 즉시 반영되지 않는 Switch

즉각적인 결과가 없는 상황에서는 Switch를 사용하지 않아요.

독립적인 기능에서만 사용하기

Switch는 독립적으로 작동하는 요소예요. '모두 선택/전체 선택'과 같은 액션이 필요한 경우 부모-자식 관계가 있는 컴포넌트(Checkbox Group 등)를 사용하는 것이 좋아요.

Do· 독립적인 설정

각 Switch가 서로 영향을 주지 않는 설정에 사용해요.

Don't· 전체 켜기 Switch

Switch 대신 부모-자식 관계가 있는 컴포넌트를 활용해요.

Disabled 상태는 명확하게 표기하기

Switch 비활성화 시, 사용자가 항목 전체의 상태를 오인하지 않도록 텍스트 레이블도 비활성화 상태로 표기하는 것을 권장해요. Switch 의 label 은 비활성일 때 자동으로 흐려져요.

Do· 라벨도 함께 비활성

Switchmark와 레이블이 함께 비활성 상태를 나타내요.

마케팅 알림
Don't· Switchmark만 비활성

Switchmark만 비활성화되면 항목 전체 상태를 오인할 수 있어요.

Switch vs. Checkbox

Checkbox와 Switch는 사용자의 선택 여부를 표시하는 컴포넌트예요.

속성CheckboxSwitch
선택값 적용저장하기 등의 액션을 수행해야 값이 저장돼요 (권장)별다른 액션이 없어도 즉시 적용돼요 (권장)
항목 구성 방식하나의 카테고리에 여러 항목으로 나열할 수 있어요개별 항목으로 구성하는 것을 권장해요
하위 항목 구성부모가 모든 하위 항목을 선택/해제할 수 있어요부모와 하위 항목 간 관계가 없어요

Props

Switch

Prop

Type

Switchmark

Prop

Type

On this page