کامپوننتها
نوار پیشرفت
نمایش پیشرفت یک کار طولانی، بههمراه اسپینر برای انتظارهای کوتاه.
import { Progress, Spinner } from "@kashi-ui/react";
نمونه
در حال بارگذاری
<Progress value={35} label="آپلود گزارش.pdf" showValue />
<Progress value={100} tone="success" label="پشتیبانگیری" showValue size="sm" />
<Progress aria-label="در حال پردازش" size="sm" /> // بدون value: نامعین
<Spinner size="sm" />دایرهای
<Progress variant="circular" value={72} showValue aria-label="پیشرفت پروژه" />
<Progress variant="circular" size="sm" aria-label="در حال پردازش" />variant="circular" با همان value، size، tone و showValue. متغیرهای CSS: --k-progress-height، --k-progress-color، --k-progress-ring-size.
ویژگیها
| نام | نوع | پیشفرض | توضیح |
|---|---|---|---|
value | number | — | مقدار؛ بدون آن نوار نامعین است |
max | number | 100 | حداکثر |
label | ReactNode | — | برچسب؛ اگر نمیدهید aria-label بدهید |
showValue | boolean | false | نمایش درصد |
size | "sm" | "md" | "lg" | "md" | ضخامت |
tone | "brand" | "success" | "warning" | "error" | "brand" | رنگ |
دسترسپذیری
role="progressbar"باaria-valuenowوaria-valuetextفارسی («۳۵٪»)؛ در حالت نامعینaria-valuenowحذف میشود.- اسپینر
role="status"با متن «در حال بارگذاری» برای صفحهخوان دارد. باprefers-reduced-motionانیمیشنها کند یا متوقف میشوند.