ComponentComponent cơ bản
Bắt đầu nhanh
Import Avatar 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 { Avatar } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử Avatar 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.
Avatar
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
src | Đường dẫn ảnh. | string | — |
alt | Mô tả ảnh (trợ năng). | string | "avatar" |
fallback | Chữ fallback khi không có ảnh. | string | "?" |
size | Kích thước avatar. | "sm" | "md" | "lg" | "xl" | "md" |
showStatus | Show status indicator dot | boolean | true |
status | Status type: online, offline, busy, away, none | StatusType | "online" |
hideStatusOnHover | Hide status dot on hover | boolean | true |
onClick | Xử lý khi click avatar. | () => void | — |
imageStrategy | Image rendering strategy. - "img": native <img> (default) — stable in dense lists, no Next.js pipeline overhead. - "next-image": uses SmartImage/next/image for CDN optimization. | "img" | "next-image" | "img" |
imageLoading | Native img `loading` attribute. Default "lazy". Use "eager" for above-the-fold avatars. | "lazy" | "eager" | "lazy" |
imageFetchPriority | Native img `fetchpriority` attribute. Useful for hero/header avatars. | "high" | "low" | "auto" | — |
Hướng dẫn sử dụng
Dùng Avatar như một khối giao diện nền tảng đáng tin cậy. Ưu tiên HTML có ngữ nghĩa, dùng biến thể có mục đích và không ghi đè các trạng thái truyền đạt ý nghĩa.
Trợ năng
Khi dùng Avatar, 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ế.