ComponentMedia & Hình ảnh
Bắt đầu nhanh
Import FallingIcons 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 { FallingIcons } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử FallingIcons 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.
FallingIcons
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
icon | Component icon hiển thị dạng hạt rơi. | IconComponent | — |
imageUrl | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
count | Số lượng hạt hiển thị. | number | DEFAULT_COUNT |
className | Class cho lớp animation bên trong. | string | — |
areaClassName | Class cho vùng bao ngoài. | string | — |
colorClassName | Class màu cho icon. | string | — |
zIndex | Z-index của lớp hiệu ứng. | number | 10 |
speedRange | Khoảng thời gian rơi (giây). | [number, number] | DEFAULT_SPEED_RANGE |
sizeRange | Khoảng kích thước icon (px). | [number, number] | DEFAULT_SIZE_RANGE |
horizontalDrift | Biên độ trôi ngang (px). | number | 24 |
spin | Xoay icon khi rơi. | boolean | true |
fullScreen | Bao phủ toàn màn hình (fixed). | boolean | false |
randomizeEachLoop | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | true |
glow | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
glowColor | Mã nguồn chưa cung cấp mô tả bổ sung. | string | "currentColor" |
glowIntensity | Mã nguồn chưa cung cấp mô tả bổ sung. | number | 0.5 |
trail | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
trailLength | Mã nguồn chưa cung cấp mô tả bổ sung. | number | 3 |
physics | Mã nguồn chưa cung cấp mô tả bổ sung. | { gravity?: number; // 0.5-2, default 1 windDirection?: number; // -1 (left) to 1 (right), default 0 windStrength?: number; // 0-1 rotation?: boolean; // Physics-based rotation } | — |
easingFunction | Mã nguồn chưa cung cấp mô tả bổ sung. | "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | "bounce" | "elastic" | "linear" |
Hướng dẫn sử dụng
Dùng FallingIcons 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 FallingIcons, 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ế.