Selection
Select
single / multiple / searchable 3 모드를 단일 컴포넌트로. cmdk + Popover 기반, IME 안전.
예제
설치 / Import
import { Select } from '@baneung-pack/ui';import { Select } from '@baneung-pack/ui/select';서브패스 import는 트리쉐이킹 친화 — 사용하지 않는 다른 컴포넌트는 번들에 포함되지 않습니다.
API
| Property | Description | Type | Default |
|---|---|---|---|
options | 후보 목록 | SelectOption[] | — |
mode | 선택 모드 | 'single' | 'multiple' | 'single' |
searchable | 검색 입력 노출 | boolean | false |
value | controlled 값 (single은 string, multiple은 string[]) | string | string[] | — |
defaultValue | uncontrolled 초기값 | string | string[] | — |
onValueChange | 값 변경 콜백 | (value: string | string[]) => void | — |
placeholder | placeholder | string | '선택…' |
emptyText | 검색 결과 없음 텍스트 | string | '결과 없음' |
maxSelected | multiple 모드 최대 선택 수 | number | — |
showSelectedCount | multiple에서 칩 대신 "N개 선택" 표시 | boolean | false |
filterFn | 커스텀 필터 | (option, query) => boolean | — |
size | 트리거 크기 | 'sm' | 'md' | 'lg' | 'md' |
disabled | 비활성 | boolean | false |