03 · Components · 입력
검색Search
사이트 또는 목록 내에서 원하는 항목을 빠르게 찾는 입력. 돋보기 아이콘과 지우기 버튼을 기본 제공합니다.
StableWCAG AA
기본
제어 컴포넌트
값을 상위 상태로 관리하면 onClear가 자동으로 빈 문자열을 상위에 전달합니다. 검색 결과 필터링과 결합하기 쉽습니다.
현재 입력값: 텍스트에어리어
네이티브 type="search"를 사용하며 role="searchbox"를 명시합니다. 가시 레이블이 없을 때는 aria-label을 반드시 부여하세요.
Props API
| Prop | Type | Default | Description |
|---|---|---|---|
size | "sm" | "md" | "lg" | "md" | 높이 32 / 40 / 48px. |
value | string | 제어 모드에서 현재 값. | |
onChange | (e) => void | 입력 이벤트 핸들러. | |
onClear | () => void | 지우기 버튼 클릭 시 호출. |