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