رفتن به محتوای اصلی

کامپوننت‌ها

سنجه

نمایش یک مقدار در برابر سقف، مثل فضای ذخیره، سهمیهٔ پیامک یا ظرفیت پلن.

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: نوار پیشرفت برای کاری است که در حال انجام است؛ سنجه برای اندازه‌ای است که ثابت است، مثل میزان مصرف. از ۸۰٪ رنگ هشدار و از ۹۵٪ رنگ بحرانی می‌گیرد و وضعیت با متن و آیکون هم گفته می‌شود.

نامنوعپیش‌فرضتوضیح
labelReactNode—نام سنجه
value / maxnumber— / 100
warning / criticalnumber۸۰٪ / ۹۵٪ maxآستانهٔ هشدار و بحرانی
format(n: number) => stringارقام فارسیقالب مقدار
labels{ ok?, warning?, critical?, of? }—متن وضعیت‌ها

دسترس‌پذیری

role="meter" با aria-valuetext کامل («۸٬۶۰۰ از ۱۰٬۰۰۰، ۸۶٪، نزدیک به سقف»). وضعیت فقط با رنگ نشان داده نمی‌شود.