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

کامپوننت‌ها

کارت آمار

نمایش شاخص‌های کلیدی (KPI) داشبورد با روند تغییر.

import { StatCard, StatGrid } from "@kashi-ui/react";

نمونه

فروش این ماه

۱۸۴٬۵۰۰٬۰۰۰تومان

۱۲٫۴٪ افزایشنسبت به ماه قبل

کاربران فعال

۳٬۸۲۰نفر

۲٪ کاهشنسبت به هفتهٔ قبل

نرخ خطا

۰٫۸٪

۳۵٪ کاهشکاهش خطا خوب است
<StatGrid>
<StatCard label="فروش این ماه" value="۱۸۴٬۵۰۰٬۰۰۰" unit="تومان" icon={<WalletIcon />}
  change={12.4} caption="نسبت به ماه قبل">
  <Sparkline points={…} />
</StatCard>
<StatCard label="کاربران فعال" value="۳٬۸۲۰" unit="نفر" change={-2} caption="نسبت به هفتهٔ قبل" />
<StatCard label="نرخ خطا" value="۰٫۸٪" change={-35} invertTrend />
</StatGrid>

ساده

سفارش‌های امروز

۴۸

<StatCard label="سفارش‌های امروز" value="۴۸" />
نامنوعپیش‌فرضتوضیح
labelReactNode—نام شاخص
valueReactNode—مقدار قالب‌بندی‌شده
unitReactNode—واحد کوچک کنار عدد، مثل «تومان»
iconReactNode—آیکون تزئینی
changenumber—درصد تغییر؛ منفی یعنی کاهش
invertTrendbooleanfalseوقتی کاهش خوب است (رنگ سبز برای کاهش)
captionReactNode—متن کنار روند
childrenReactNode—نمودار کوچک یا محتوای اضافه

StatGrid کارت‌ها را در ستون‌های خودکار (حداقل ۱۴rem) می‌چیند.

عدد با ارقام فارسی و عرض طبیعی نمایش داده می‌شود (نه tabular-nums)، چون ارقام فارسی با عرض ثابت از هم فاصله می‌گیرند. اندازهٔ عدد با --k-stat-value-size عوض می‌شود.

دسترس‌پذیری

جهت روند فقط با رنگ و فلش نشان داده نمی‌شود: صفحه‌خوان متن کامل را می‌خواند («۱۲٫۴٪ افزایش»). رنگ روند بر اساس خوب یا بد بودن است، نه جهت.