شارك المقالة
سلة مشتريات Flutter: الكمية والإجمالي بمثال مستقل

سلة مشتريات Flutter: الكمية والإجمالي بمثال مستقل

إنشاء سلة مشتريات Flutter بمثال مستقل لإضافة المنتجات وتغيير الكمية وحساب الإجمالي بوحدات صحيحة، مع فصل الحالة المحلية عن اعتماد…

إنشاء سلة مشتريات Flutter بمثال مستقل لإضافة المنتجات وتغيير الكمية وحساب الإجمالي بوحدات صحيحة، مع فصل الحالة المحلية عن اعتماد الطلب بالخادم.

بديل عملي للرابط الذي لم يعد متاحًا

رابط المستودع الذي اعتمد عليه الشرح القديم لم يعد متاحًا علنًا وقت المراجعة، لذلك لا نعد بتنزيل مشروع منه أو نستبدله بمصدر مختلف مع ادعاء أنه المشروع نفسه. يقدم هذا الدرس مثال سلة مستقلًا يمكن دمجه مع واجهة متجر من القسم. صور الشرح الأصلية محفوظة كمرجع بصري، لكنها لا تعني أن المثال الجديد نسخة مطابقة لذلك المستودع.

المنتج وبند السلة

المنتج يحمل معرفًا واسمًا وسعرًا تجريبيًا، بينما بند السلة يضيف كمية. معرف البند قد يحتاج خيارات الحجم واللون إذا كان المنتج متعدد الخيارات؛ اسم المنتج وحده لا يميز كل نسخة. المثال يستخدم معرفًا ثابتًا ويمنع كميات سالبة أو تجاوز الحد التعليمي المختار. عند إزالة آخر وحدة يحذف البند بدل إظهار صف بكمية صفر، وتبقى القائمة الفارغة حالة صحيحة لها إجمالي صفر.

حساب بوحدات صحيحة

يخزن المثال السعر بوحدات صغيرة صحيحة لعملة مفترضة ذات منزلتين، ثم يقسم عند العرض فقط. هذا يتجنب أخطاء جمع double الشائعة في عرض سلة بسيطة. لا تعمم المقسوم عليه على كل عملة، ولا تضف شحنًا أو خصمًا أو ضريبة ضمن رقم لا يعرف المستخدم مصدره. قيم المثال تعليمية؛ الخادم هو الذي يعيد السعر والمخزون والإجمالي المعتمد عند إنشاء طلب حقيقي.

مكون واحد وحالة واحدة

يمتلك CartDemo حالة السلة ويعرضها في قائمة عناصر، ويمكن لاحقًا نقل الموديل إلى إدارة حالة تشاركه الصفحات. لا تحتفظ بكمية منفصلة في تفاصيل المنتج وأخرى في السلة دون مصدر موحد. حدّث المجموع بعد الإضافة والإزالة، واجعل الزر والاسم والوحدة واضحين مع تكبير الخط وRTL. التخزين المحلي اختياري وله سياسة ترحيل، ولا يثبت وجود مخزون أو حجز لدى الخادم.

اختبارات أساسية قبل الربط

جرب إضافة منتج مرتين ثم تقليله وحذفه وإفراغ السلة وإضافة منتجين مختلفين. ارفض كمية غير صالحة، ولا تعرض نجاح شراء لأن زرًا في المثال غير متصل بخدمة. عند ربط API اختبر تغير السعر ونفاد المخزون وإعادة المحاولة حتى لا تنشئ طلبًا مكررًا. مثال التقرير PDF المرتبط يصلح لتعلم عرض ملخص بيانات، لكنه لا ينشئ فاتورة معتمدة أو بديلًا لعقد الطلب.

المثال البرمجي

ضع المكون داخل مشروع Flutter وصفحة مناسبة في MaterialApp. الكود التالي مثال مستقل للجزء المشروح، ولا يعتمد على ملفات تطبيق خارجي غير مرفقة. راجع المتطلبات المذكورة في النص، خاصة الخط والحزم في مثال PDF.

import 'package:flutter/material.dart';

class Product {
  Product(this.id, this.name, this.priceMinor) {
    if (id.isEmpty || priceMinor < 0) throw ArgumentError('Invalid product');
  }
  final String id;
  final String name;
  final int priceMinor;
}
class Cart {
  final Map<String, Product> _products = {};
  final Map<String, int> _quantities = {};
  int quantity(String id) => _quantities[id] ?? 0;
  void add(Product product) {
    final old = _products[product.id];
    if (old != null && old.priceMinor != product.priceMinor) {
      throw StateError('Refresh the cart price explicitly');
    }
    final next = quantity(product.id) + 1;
    if (next > 99) throw StateError('Quantity limit reached');
    _products[product.id] = product;
    _quantities[product.id] = next;
  }
  void decrement(String id) {
    final next = quantity(id) - 1;
    if (next <= 0) { _quantities.remove(id); _products.remove(id); }
    else { _quantities[id] = next; }
  }
  int get totalMinor => _quantities.entries.fold(0,
    (sum, entry) => sum + _products[entry.key]!.priceMinor * entry.value);
}
class CartDemo extends StatefulWidget {
  const CartDemo({super.key});
  @override
  State<CartDemo> createState() => _CartDemoState();
}
class _CartDemoState extends State<CartDemo> {
  final _cart = Cart();
  final _catalog = [Product('coffee', 'قهوة', 1250), Product('tea', 'شاي', 750)];
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('سلة تجريبية')),
    body: ListView(children: [
      for (final product in _catalog) ListTile(
        title: Text(product.name),
        subtitle: Text('الكمية: ${_cart.quantity(product.id)}'),
        trailing: Row(mainAxisSize: MainAxisSize.min, children: [
          IconButton(tooltip: 'تقليل', onPressed: () => setState(() => _cart.decrement(product.id)),
            icon: const Icon(Icons.remove)),
          IconButton(tooltip: 'إضافة', onPressed: _cart.quantity(product.id) >= 99 ? null
            : () => setState(() => _cart.add(product)), icon: const Icon(Icons.add)),
        ]),
      ),
      Padding(padding: const EdgeInsets.all(16),
        child: Text('الإجمالي التجريبي: ${(_cart.totalMinor / 100).toStringAsFixed(2)}')),
    ]),
  );
}

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع