بطاقة الإحصاءات (Stats Card)
تعرض كتلة بطاقة الإحصاءات (Stats Card) المقاييس الأساسية مع الاتجاه والأيقونات.
التثبيت
bash
npx @smicolon/cli add stats-cardقبل إضافة أي مكوّن، شغّل الأمر init مرة واحدة في مشروعك. التفاصيل في صفحة التثبيت.
معاينة
الإيرادات
48,200 ر.س
+12.5%مقارنة بالشهر الماضي
الطلبات
1,284
+8%مقارنة بالشهر الماضي
المرتجعات
36
-2.1%مقارنة بالشهر الماضي
الميزات
- عرض العنوان والقيمة
- مؤشر الاتجاه، صعودًا أو هبوطًا مع النسبة
- أيقونة اختيارية
- نص وصفي
- حالة التحميل
- الجزء
StatsGridلتخطيط البطاقات
الخصائص (props)
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
title | string | لا يوجد | التسمية فوق القيمة. |
value | string | number | لا يوجد | القيمة الرئيسية. |
description | string | لا يوجد | نص تحت القيمة. |
icon | ReactNode | لا يوجد | أيقونة في الزاوية. |
trend | { value, direction: "up" | "down" | "neutral" } | لا يوجد | التغيّر، مع سهم للصعود أو الهبوط. |
loading | boolean | false | يعرض هيكل التحميل أثناء التحميل. |
StatsGrid | { columns: 2 | 3 | 4 } | لا يوجد | يرتّب البطاقات في عمودين أو ثلاثة أو أربعة. |
className | string | لا يوجد | أصناف (class) إضافية للمكوّن. |