03 · Components · 설정
언어 선택Language Selector
다국어 사이트에서 사용자가 UI 언어를 전환. 언어 이름은 항상 해당 언어로 표기하세요(영어 → English, 일본어 → 日本語).
StableWCAG AA
기본
사용 가이드
- 헤더 우측 끝에 배치하는 것이 가장 익숙합니다.
- 3개 이하는 인라인 탭 형태, 4개 이상은 Popover + 목록으로 전환하세요.
- 선택 시 URL/localStorage에 저장하고 페이지 reload 또는 라우팅.
role="radiogroup" + role="radio"로 언어 중 하나를 선택하는 구조임을 보조 기술에 알립니다. 각 항목은aria-checked로 선택 상태를 표현합니다.
Props API
| Prop | Type | Default | Description |
|---|---|---|---|
languages | { value, label }[] | 표시할 언어 목록. | |
value | string | 현재 선택된 언어 값. | |
onChange | (value: string) => void | 선택 변경 콜백. |