Flutter购物车管理插件miladtech_shopping_cart的使用

Flutter购物车管理插件miladtech_shopping_cart的使用

miladtech_shopping_cart 是一个用于简化购物车管理的Flutter插件。它可以帮助你执行基本的购物车操作，如添加、删除商品，获取商品总数，清空购物车，并且可以管理单个和多个供应商的商品。

支持平台

推荐使用状态管理

建议在项目中使用状态管理库，例如 Provider。

使用 miladtech_shopping_cart

要使用该插件，只需将以下代码添加到你的 pubspec.yaml 文件中并运行 dart pub get：

dependencies:
  miladtech_shopping_cart: ^1.0.0+1

开始使用

1. 在项目的主方法中初始化 flutter shopping cart 包：

   await ShoppingCart().init();
   

2. 创建一个 flutter shopping cart 的实例：

   var shoppingCart = ShoppingCart();
   

3. 获取内置方法以进行购物车操作：

   • 添加商品到购物车：

     shoppingCart.addToCart(
       productId: 1, // 商品ID
       vendorId: 1, // 供应商ID
       unitPrice: 10.0, // 单价
       itemImage: 'item_image_url', // 商品图片URL
       productName: 'Product Name', // 商品名称（可选）
       cartName: 'main', // 购物车名称（可选，默认为'main'）
       quantity: 1, // 数量（可选，默认为1）
       cartItemOptionList: [], // 商品选项列表（可选，默认为空）
       productDetailsObject: {}, // 商品详情对象（可选）
     );
     

   • 从购物车中移除商品：

     shoppingCart.decrementItemFromCart(
       productId: 1, // 商品ID
       vendorId: 1, // 供应商ID
       cartName: 'main', // 购物车名称（可选，默认为'main'）
       cartItemOptionList: [], // 商品选项列表（可选，默认为空）
     );
     

   • 获取购物车中的总金额：

     double totalAmount = await shoppingCart.getTotalAmount();
     

   • 获取购物车中的总金额（含税）：

     double totalAmountWithTax = await shoppingCart.getTotalAmountWithTax();
     

   • 获取购物车中的商品数量：

     int itemCount = await shoppingCart.getCartItemCount(isQuantityCount: true);
     

   • 获取特定商品信息：

     ShoppingCartItem? specificItem = shoppingCart.getSpecificItemFromCart(
       productId: 1, // 商品ID
       cartItemOptionList: [], // 商品选项列表（可选）
       vendorId: 1, // 供应商ID（可选）
     );
     

   • 查找特定商品在购物车中的索引：

     int? itemIndex = shoppingCart.findItemIndexFromCart(1);
     

   • 删除特定商品：

     shoppingCart.deleteSelectedCartItem(1, 'main');
     

   • 清空购物车：

     shoppingCart.deleteAllCart();
     

示例代码

以下是一个完整的示例代码，展示了如何使用 miladtech_shopping_cart 插件来实现购物车功能。

import 'package:flutter/material.dart';
import 'package:miladtech_shopping_cart/miladtech_shopping_cart.dart';
import 'package:provider/provider.dart';

void main() async {
  /// 初始化购物车插件
  WidgetsFlutterBinding.ensureInitialized();
  await ShoppingCart().init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MultiProvider(
      providers: [
        ChangeNotifierProvider(create: (_) => CartProvider()),
        ChangeNotifierProvider(create: (_) => ProviderShoppingCart()),
      ],
      child: MaterialApp(
        debugShowCheckedModeBanner: false,
        title: 'Flutter Shopping Cart',
        theme: ThemeData(
          primarySwatch: Colors.blue,
          visualDensity: VisualDensity.adaptivePlatformDensity,
        ),
        home: MyCatalog(),
        initialRoute: '/catalog',
        routes: {
          '/catalog': (context) => const MyCatalog(),
          '/cart': (context) => const MyCart(),
        },
      ),
    );
  }
}

class MyCatalog extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Catalog')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 添加商品到购物车
            ShoppingCart().addToCart(
              productId: 1,
              vendorId: 1,
              unitPrice: 10.0,
              itemImage: 'item_image_url',
              productName: 'Product Name',
              quantity: 1,
            );
          },
          child: Text('Add to Cart'),
        ),
      ),
    );
  }
}

class MyCart extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Cart')),
      body: Center(
        child: FutureBuilder<double>(
          future: ShoppingCart().getTotalAmount(),
          builder: (context, snapshot) {
            if (snapshot.hasData) {
              return Text('Total Amount: ${snapshot.data}');
            } else if (snapshot.hasError) {
              return Text('Error: ${snapshot.error}');
            }
            return CircularProgressIndicator();
          },
        ),
      ),
    );
  }
}