ComponentMedia & Hình ảnh
Bắt đầu nhanh
Import FileUpload từ entry công khai. Các ví dụ bên dưới thể hiện những kiểu tương tác và cấu hình được hỗ trợ.
component.tsxtsx
import { FileUpload } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử FileUpload thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
Đang tải ví dụ tương tác…
Tham chiếu
Tham chiếu API
Tra cứu các thuộc tính, kiểu dữ liệu được chấp nhận, giá trị mặc định và lưu ý về hành vi.
Dữ liệu được sinh từ API TypeScript công khai của thư viện. Kiểu dữ liệu, thuộc tính bắt buộc và giá trị mặc định luôn đồng bộ với mã nguồn.
FileUpload
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
onUpload | Callback when a file is uploaded | (file: UploadedFile) => void | — |
onRemove | Callback when a file is removed | (fileId: string | number) => void | — |
onChange | Callback when files change | (files: UploadedFile[]) => void | — |
uploadHandler | Custom upload handler - if provided, handles actual upload | (file: File) => Promise<UploadedFile> | — |
maxSize | Maximum file size in MB | number | 50 |
maxFiles | Maximum number of files | number | 10 |
accept | Accepted file types (e.g., ".pdf,.doc" or "image/*,application/pdf") | string | — |
multiple | Allow multiple files | boolean | true |
disabled | Disabled state | boolean | false |
className | Additional class names | string | — |
showFileList | Show file list | boolean | true |
variant | Layout variant | "default" | "compact" | "minimal" | "default" |
size | Size variant | "sm" | "md" | "lg" | "md" |
dragDropText | Custom drag/drop text | string | — |
browseText | Custom browse button text | string | — |
supportedFormatsText | Custom supported formats text | string | — |
showTypeIcons | Show file type icons | boolean | true |
allowPreview | Allow file preview (for images) | boolean | true |
initialFiles | Initial files | UploadedFile[] | [] |
Hướng dẫn sử dụng
Dùng FileUpload với nội dung thay thế có ý nghĩa, kích thước rõ ràng và chiến lược tải phù hợp. Tối ưu tài nguyên trước khi đưa vào component.
Trợ năng
Khi dùng FileUpload, hãy giữ trạng thái focus dễ nhận biết, cung cấp tên truy cập khi cần và kiểm tra bàn phím cùng trình đọc màn hình trong ngữ cảnh thực tế.