ComponentComponent cơ bản
Bắt đầu nhanh
Import Progress 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 { Progress } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử Progress 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.
Progress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Giá trị 0..max. | number | Bắt buộc |
max | Giá trị tối đa. | number | 100 |
className | Class tuỳ chỉnh. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
size | Kích thước. | "sm" | "md" | "lg" | "xl" | "md" |
showValue | Hiển thị %/giá trị. | boolean | false |
label | Nhãn phía trên. | string | — |
animated | Hiệu ứng chuyển động. | boolean | false |
striped | Nền kẻ sọc. | boolean | false |
indeterminate | Chế độ indeterminate. | boolean | false |
description | Mô tả. | string | — |
status | normal | error | complete. | "normal" | "error" | "complete" | "normal" |
BatteryProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Phần trăm pin. | number | Bắt buộc |
max | Tối đa (100). | number | 100 |
className | Class tuỳ chỉnh. | string | — |
charging | Hiển thị đang sạc. | boolean | false |
showValue | Hiển thị %. | boolean | false |
CircularProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Giá trị 0..max. | number | Bắt buộc |
max | Giá trị tối đa. | number | 100 |
size | Đường kính (px). | number | 64 |
strokeWidth | Mã nguồn chưa cung cấp mô tả bổ sung. | number | 4 |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
showValue | Hiển thị %. | boolean | false |
children | Mã nguồn chưa cung cấp mô tả bổ sung. | React.ReactNode | — |
indeterminate | Chế độ indeterminate. | boolean | false |
status | Mã nguồn chưa cung cấp mô tả bổ sung. | "normal" | "error" | "complete" | "normal" |
trackColor | Mã nguồn chưa cung cấp mô tả bổ sung. | string | "stroke-muted/20" |
LoadingProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Giá trị 0..max. | number | Bắt buộc |
max | Giá trị tối đa. | number | 100 |
className | Class tuỳ chỉnh. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
label | Nhãn. | string | — |
status | loading | complete | error | paused. | "loading" | "complete" | "error" | "paused" | "loading" |
speed | Tốc độ. | string | — |
timeRemaining | Thời gian còn lại. | string | — |
MiniProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Giá trị 0..max. | number | Bắt buộc |
max | Giá trị tối đa. | number | 100 |
className | Class tuỳ chỉnh. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
showValue | Hiển thị %. | boolean | false |
SegmentedProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
segmentsBắt buộc | Số đoạn. | number | Bắt buộc |
activeSegmentsBắt buộc | Số đoạn kích hoạt. | number | Bắt buộc |
className | Class tuỳ chỉnh. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
size | Kích thước. | "sm" | "md" | "lg" | "md" |
StepProgress
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
stepsBắt buộc | Danh sách bước. | string[] | Bắt buộc |
currentStepBắt buộc | Bước hiện tại (0-based). | number | Bắt buộc |
className | Class tuỳ chỉnh. | string | — |
variant | Biến thể màu. | "default" | "primary" | "success" | "warning" | "danger" | "info" | "primary" |
size | Kích thước. | "sm" | "md" | "lg" | "md" |
Hướng dẫn sử dụng
Dùng Progress 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 Progress, 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ế.