کامپوننتها
سنجه
نمایش یک مقدار در برابر سقف، مثل فضای ذخیره، سهمیهٔ پیامک یا ظرفیت پلن.
import { Meter } from "@kashi-ui/react";
نمونه
فضای ذخیرهسازی۴٫۲ گیگابایت از ۱۰ گیگابایت
سهمیهٔ پیامک این ماه۸٬۶۰۰ از ۱۰٬۰۰۰
کاربران پلن تیمی۴۹ نفر از ۵۰ نفر
<Meter label="فضای ذخیرهسازی" value={4.2} max={10} format={(n) => `${n} گیگابایت`} />
<Meter label="سهمیهٔ پیامک این ماه" value={8600} max={10000} />
<Meter label="کاربران پلن تیمی" value={49} max={50} />فرق آن با Progress: نوار پیشرفت برای کاری است که در حال انجام است؛ سنجه برای اندازهای است که ثابت است، مثل میزان مصرف. از ۸۰٪ رنگ هشدار و از ۹۵٪ رنگ بحرانی میگیرد و وضعیت با متن و آیکون هم گفته میشود.
| نام | نوع | پیشفرض | توضیح |
|---|---|---|---|
label | ReactNode | — | نام سنجه |
value / max | number | — / 100 | |
warning / critical | number | ۸۰٪ / ۹۵٪ max | آستانهٔ هشدار و بحرانی |
format | (n: number) => string | ارقام فارسی | قالب مقدار |
labels | { ok?, warning?, critical?, of? } | — | متن وضعیتها |
دسترسپذیری
role="meter" با aria-valuetext کامل («۸٬۶۰۰ از ۱۰٬۰۰۰، ۸۶٪، نزدیک به سقف»). وضعیت فقط با رنگ نشان داده نمیشود.