مكون خفيف الوزن لـ Framer يعرض عدد العناصر الموجودة حاليًا في عربة التسوق من خلال القراءة من localStorage والتحديث في الوقت الفعلي عند تغيير عربة التسوق.
ما الذي يفعله
يعرض عداد عناصر عربة التسوق رقمًا واحدًا — عدد العناصر في عربة التسوق — كعنصر نص منسق. صُمِّم للوضع في شريط التنقل أو منطقة أيقونة عربة التسوق لإعطاء المستخدمين عدادًا مباشرًا لعدد العناصر التي أضافوها. السلوكيات الرئيسية:- يقرأ عربة التسوق من
localStorage— عند التحميل، يقرأ المفتاحcartمنlocalStorageويحسب عدد العناصر في المصفوفة. - يتحدث في الوقت الفعلي — يستمع لحدث
cartUpdatedالمخصص علىwindow. كلما أطلق مكون آخر (مثل زر إضافة إلى عربة التسوق) هذا الحدث، يُعيد العداد قراءةlocalStorageويحدّث الرقم المعروض فورًا دون إعادة تحميل الصفحة. - لا يعرض شيئًا حتى التحميل — العدد يكون فارغًا عند أول عرض قبل قراءة
localStorage، لذا لا يظهر رقم عنصر نائب يومض على الشاشة أثناء التحميل.
ضوابط الخصائص
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
| Font | خط | 12px | الطباعة لنص العداد (العائلة، الحجم، الوزن، إلخ). |
| Color | لون | #181A2C | لون نص رقم العداد. |
ملاحظات
- يعرض العداد عدد عناصر السطر في مصفوفة عربة التسوق، وليس الكمية الإجمالية. إذا أُضيف نفس المنتج مرتين كإدخالات منفصلة، سيُظهر العداد
2. - يجب تخزين عربة التسوق في
localStorageتحت المفتاحcartكمصفوفة JSON. يجب على أي مكون يعدّل عربة التسوق إطلاق حدثcartUpdatedعلىwindowبعد الكتابة فيlocalStorageحتى يتحدث العداد — وإلا سيعكس فقط الحالة من تحميل الصفحة الأولي. - لا يعرض المكون أي حالة احتياطية أو صفرية — إذا لم يكن هناك مفتاح
cartفيlocalStorage، لا يعرض العداد شيئًا.