03 · Components · 입력
파일 업로드File Upload
드래그·드롭과 클릭 모두 지원하는 파일 업로드. 허용 형식·최대 용량 힌트를 드롭존 안에 함께 두세요.
StableWCAG AA
기본
다중 업로드
multiple을 켜면 기존 파일에 추가 누적되며, 각 항목의 X 버튼으로 개별 제거할 수 있습니다.
드롭존 자체가 버튼이므로 키보드로도 Tab → Enter/Space로 파일 선택창 을 열 수 있습니다. 각 파일 항목의 제거 버튼에는 파일명을 포함한 aria-label이 부여됩니다.
Props API
| Prop | Type | Default | Description |
|---|---|---|---|
accept | string | 허용 MIME/확장자 (예: ".pdf,.png"). | |
multiple | boolean | false | 다중 파일 선택 허용. |
maxSize | number (bytes) | 초과 파일은 자동 제외. | |
onFilesChange | (files: File[]) => void | 파일 목록 변경 콜백. | |
hint | string | 드롭존 안쪽 보조 안내 텍스트. |