عن المشروع

بطاقة Mini Graph Card هي بطاقة Lovelace مخصصة لـ Home Assistant تعرض الحالة الحالية لكيانات sensor وbinary_sensor إلى جانب رسم بياني خطي أو شريطي لتاريخها. يتم تثبيتها عبر HACS، أو يدويًا بنسخ الحزمة إلى config/www، أو عبر تنزيل CLI، ثم تُشار إليها كمورد وحدة JavaScript في Lovelace. تُهيأ البطاقة بصيغة YAML. الخيارات المطلوبة هي type (custom:mini-graph-card) وentities، وهي قائمة بكيانات الحساسات. يمكن أن يكون كل كيان معرّف كيان عادي أو كائنًا يحتوي على خيارات مثل attribute وname وcolor وunit وaggregate_func وshow_state وshow_legend_state وshow_indicator وshow_graph وshow_line وshow_fill وshow_points وshow_legend وstate_adaptive_color وy_axis وfixed_value وsmoothing. تشمل الخيارات على مستوى البطاقة icon وicon_image وname وunit وtap_action وgroup وhours_to_show وpoints_per_hour وaggregate_func وgroup_by وupdate_interval وcache وshow وanimate وheight وbar_spacing وline_width وline_color وcolor_thresholds وcolor_thresholds_transition وdecimals وhour24 وfont_size وfont_size_header وalign_header وalign_icon وalign_state وlower_bound وupper_bound وmin_bound_range وحدود ثانوية وsmoothing وstate_map وvalue_factor وlogarithmic. تتحكم قائمة show في عناصر الواجهة: name وicon وstate وgraph (line أو bar أو false) وfill وpoints وlegend وaverage وextrema وlabels وlabels_secondary وname_adaptive_color وicon_adaptive_color وloading_indicator. تشمل دوال التجميع avg وmedian وmin وmax وfirst وlast وsum وdelta وdiff. يمكن تجميع البيانات حسب الفاصل الزمني أو التاريخ أو الساعة. تدعم عتبات الألوان انتقالات سلسة أو حادة واستيفاء قيم التوقف المتوسطة. يمكن تعيين الحالات غير الرقمية إلى تسميات عبر state_map، ويمكن الوصول إلى الخصائص في القواميس أو القوائم المتداخلة باستخدام مسارات منقطة. تغطي الأمثلة بطاقات الكيان الواحد، والأنماط البديلة، والكيانات المتعددة، والرسوم البيانية الشريطية، والتاريخ الأسبوعي، والبطاقات التي تعرض الرسم فقط، والتكديس الأفقي، وألوان الخطوط الديناميكية، والمحور الصادي الثانوي، والتجميع حسب التاريخ، ودوال التجميع، والمستشعرات الثنائية، وعرض كيانات إضافية للحالة فقط. تتيح متغيرات السمة mcg-title-letter-spacing وmcg-title-font-weight تخصيص المظهر. يتطلب التطوير nodejs وnpm، مع سكربتات npm run build وnpm run watch.