ComponentMedia & Hình ảnh
Bắt đầu nhanh
Import ImageUpload 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 { ImageUpload } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử ImageUpload 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.
ImageUpload
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
onUpload | Callback khi tải xong. | (image: UploadedImage) => void | — |
onRemove | Callback khi xoá ảnh. | (imageId: string) => void | — |
maxSize | Kích thước tối đa (MB). | number | parseInt(process.env.NEXT_PUBLIC_MAX_FILE_SIZE || "10485760") / (1024 * 1024) |
accept | Kiểu file cho phép. | string | "image/*" |
multiple | Cho phép nhiều file. | boolean | false |
disabled | Vô hiệu hoá. | boolean | false |
className | Class tuỳ chỉnh. | string | — |
showPreview | Hiển thị danh sách xem trước. | boolean | true |
previewSize | Kích thước preview (sm|md|lg). | "sx" | "sm" | "md" | "lg" | "md" |
dragDropText | Chuỗi hướng dẫn kéo & thả. | string | — |
browseText | Nút chọn tệp. | string | — |
supportedFormatsText | Chuỗi định dạng hỗ trợ. | string | — |
uploadAreaHeight | Chiều cao tùy chỉnh cho vùng tải lên. | string | number | — |
Hướng dẫn sử dụng
Dùng ImageUpload 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 ImageUpload, 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ế.