ComponentMedia & Hình ảnh
Bắt đầu nhanh
Import SmartImage 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 { SmartImage } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử SmartImage 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.
SmartImage
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
srcBắt buộc | URL ảnh. | string | undefined | null | Bắt buộc |
altBắt buộc | Văn bản thay thế. | string | Bắt buộc |
className | Class tuỳ chỉnh cho wrapper. | string | — |
ratioClass | Aspect ratio utility class, e.g. `aspect-square`, `aspect-4/3`. If provided with `fill`, the wrapper enforces the ratio. | string | — |
roundedClass | Rounded corners; defaults to `rounded-lg` to match project style. | string | "rounded-2xl md:rounded-3xl" |
fill | When true, uses fill layout; otherwise width/height if provided. | boolean | true |
width | Chiều rộng khi fill=false. | number | — |
height | Chiều cao khi fill=false. | number | — |
sizes | Thuộc tính sizes responsive. | string | "(max-width: 768px) 100vw, 33vw" |
priority | Cờ priority (Next/Image). | boolean | false |
quality | Chất lượng ảnh (1-100). | number | 80 |
fit | Object-fit (cover|contain). | Fit | "cover" |
objectPosition | Control object position, e.g. 'center', 'top', 'left', '50% 50%'. | React.CSSProperties["objectPosition"] | — |
fallbackSrc | Optional fallback src if original fails. | string | DEFAULT_FALLBACK |
imageClassName | Class tuỳ chỉnh cho thẻ ảnh. | string | — |
transition | Enable fade-in transition on the image. Default false — avoids making reloads/repaints visible. | boolean | false |
unoptimized | Pass through next/image `unoptimized`. Useful when CDN optimization is not needed. | boolean | false |
Hướng dẫn sử dụng
Dùng SmartImage 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 SmartImage, 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ế.