بطاقة الإحصاءات (Stats Card)

تعرض كتلة بطاقة الإحصاءات (Stats Card) المقاييس الأساسية مع الاتجاه والأيقونات.

التثبيت

bash
npx @smicolon/cli add stats-card

قبل إضافة أي مكوّن، شغّل الأمر init مرة واحدة في مشروعك. التفاصيل في صفحة التثبيت.

معاينة

الإيرادات

48,200 ر.س

+12.5%مقارنة بالشهر الماضي

الطلبات

1,284

+8%مقارنة بالشهر الماضي

المرتجعات

36

-2.1%مقارنة بالشهر الماضي

الميزات

  • عرض العنوان والقيمة
  • مؤشر الاتجاه، صعودًا أو هبوطًا مع النسبة
  • أيقونة اختيارية
  • نص وصفي
  • حالة التحميل
  • الجزء StatsGrid لتخطيط البطاقات

الخصائص (props)

الخاصيةالنوعالافتراضيالوصف
titlestringلا يوجدالتسمية فوق القيمة.
valuestring | numberلا يوجدالقيمة الرئيسية.
descriptionstringلا يوجدنص تحت القيمة.
iconReactNodeلا يوجدأيقونة في الزاوية.
trend{ value, direction: "up" | "down" | "neutral" }لا يوجدالتغيّر، مع سهم للصعود أو الهبوط.
loadingbooleanfalseيعرض هيكل التحميل أثناء التحميل.
StatsGrid{ columns: 2 | 3 | 4 }لا يوجديرتّب البطاقات في عمودين أو ثلاثة أو أربعة.
classNamestringلا يوجدأصناف (class) إضافية للمكوّن.