Select
Betav1.0.0옵션 리스트에서 하나 선택. 키보드 네비게이션.
Loading…
Installation
pnpm dlx @groudit/cli@latest add selectVariants
Single (basic)
가장 단순한 형태 — 한 번에 하나만 선택.
Loading…
Grouped
SelectGroup + SelectLabel + SelectSeparator 로 항목 분류.
Loading…
With icons
각 옵션 앞에 아이콘 — 국가 플래그·상태 표시·카테고리 등.
Loading…
Searchable / Combobox
옵션이 많을 때 — Command + Popover 조합으로 입력 + 필터링.
Loading…
With description
옵션마다 보조 설명을 함께 표시 — 플랜 선택, 권한 등급 등.
Loading…
States (disabled / invalid)
비활성화, 폼 에러, 일부 항목만 disabled 등 다양한 상태.
Loading…
Composition
Select
├── SelectTrigger
│ └── SelectValue
└── SelectContent
├── SelectGroup
│ ├── SelectLabel
│ └── SelectItem
├── SelectSeparator
└── SelectItemDependencies
설치 시 자동으로 함께 들어오는 의존성. 모든 버전은 정확히 고정되어 자동 업데이트를 방지합니다.
npm packages
| Package | Version |
|---|---|
| @base-ui/react | 1.5.0 |
| clsx | 2.1.1 |
| tailwind-merge | 3.6.0 |
| lucide-react | 1.17.0 |
Accessibility
이 컴포넌트는 WAI-ARIA combobox 패턴을 따릅니다.
Keyboard interactions
| Key | Description |
|---|---|
SpaceEnter | 옵션 리스트 열기. |
↑↓ | 옵션 간 이동. |
HomeEnd | 첫/마지막 옵션. |
타이핑 | 해당 글자로 시작하는 옵션으로 점프. |
Esc | 옵션 리스트 닫기. |