Flutter购物车数量步进器插件cart_stepper的使用

发布于 1周前 作者 nodeper 来自 Flutter

Flutter购物车数量步进器插件cart_stepper的使用

cart_stepper简介

cart_stepper是一个完全可定制的Flutter小部件,用于获取数量。它适用于电商应用中获取购物车的数量。

此包是从AYNStepperView分叉而来。

Preview

参数介绍

  • count: int/double, 显示的数字。
  • stepper: int/double, 增加或减少的数量。
  • size: double, 小部件大小。
  • axis: Axis, 布局方向。
  • numberSize: double, 数字间距,默认为2。
  • didChangeCount: Function, 必须设置以释放计数器。
  • style: CartStepperStyle,样式配置。
  • alwaysExpanded: bool, 当值为0时是否始终展开。
  • elevation: double, 在小部件周围显示阴影。

CartStepperStyle:

  • activeForegroundColor: Color, 计数器> 0时的文本颜色。
  • activeBackgroundColor: Color, 计数器> 0时的背景颜色。
  • foregroundColor: Color, 计数器== 0时的文本颜色。
  • backgroundColor: Color, 计数器== 0时的背景颜色。
  • shape: BoxShape,形状。
  • radius: Radius, 小部件的圆角半径,默认计算一个圆角矩形。
  • BoxBorder: 小部件的边框。
  • shadowColor: Color,阴影颜色。
  • textStyle,文本样式。
  • iconTheme = const IconThemeData()
  • iconPlus: IconData, 自定义加号图标。
  • iconMinus: IconData, 自定义减号图标。
  • buttonAspectRatio: 加号和减号按钮的纵横比,默认为1。
  • elevation: 小部件的阴影高度。

使用方法

创建一个用于显示和修改数量的小部件:

Widget _buildStepper() {
  return CartStepperInt(
        count: _counter,
        size: 30,
        style: CartStepperTheme.of(context).copyWith(activeForegroundColor: Colors.purple,),
        didChangeCount: (count) {
          setState(() {
            _counter = count;
          });
        },
  );
}

迁移指南(从3.x到4.x)

在从版本3.x迁移到4.x时,需要注意以下属性名称的变化:

  • deActiveForegroundColor => foregroundColor
  • deActiveBackgroundColor => backgroundColor

示例代码

下面是一个完整的示例代码,演示了如何在项目中使用cart_stepper插件:

import 'package:flutter/material.dart';
import 'package:cart_stepper/cart_stepper.dart';
import 'package:intl/intl.dart';

void main() => runApp(const MyApp());

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(
        title: "Cart Stepper View",
      ),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counterInit = 0;
  int _counter = 1;
  int _counterLimit = 1;

  double _dCounter = 0.01;

  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: ListView(
          children: <Widget>[
            Row(
              children: [
                Expanded(
                  child: Column(
                    mainAxisSize: MainAxisSize.min,
                    children: [
                      const Center(
                        child: Padding(
                          padding: EdgeInsets.only(top: 8),
                          child: Text('普通调用:'),
                        ),
                      ),
                      Padding(
                        padding: const EdgeInsets.all(8.0),
                        child: CartStepperInt(
                          style: CartStepperStyle.fromTheme(
                            Theme.of(context),
                            radius: Radius.zero,
                          ),
                          elevation: 7,
                          value: _counterInit,
                          didChangeCount: (count) {
                            setState(() {
                              _counterInit = count;
                            });
                          },
                        ),
                      ),
                      Padding(
                        padding: const EdgeInsets.all(8.0),
                        child: CartStepperDouble(
                          value: _dCounter,
                          stepper: 0.01,
                          format: NumberFormat('##0.00'),
                          didChangeCount: (count) {
                            setState(() {
                              _dCounter = (count * 100).round() / 100;
                            });
                          },
                        ),
                      ),
                    ],
                  ),
                ),
                Expanded(
                  child: Column(
                    mainAxisSize: MainAxisSize.min,
                    children: [
                      const Center(
                        child: Padding(
                          padding: EdgeInsets.only(top: 25),
                          child: Text('纵向:'),
                        ),
                      ),
                      Row(
                        mainAxisAlignment: MainAxisAlignment.center,
                        children: [
                          Padding(
                            padding: const EdgeInsets.all(8.0),
                            child: CartStepperInt(
                              value: _counter,
                              axis: Axis.vertical,
                              didChangeCount: (count) {
                                setState(() {
                                  _counter = count;
                                });
                              },
                            ),
                          ),
                          Padding(
                            padding: const EdgeInsets.all(8.0),
                            child: CartStepperInt(
                              value: _counter,
                              axis: Axis.vertical,
                              style: CartStepperTheme.of(context).copyWith(
                                activeBackgroundColor: Colors.white,
                                activeForegroundColor: Colors.blue,
                                border: Border.all(
                                  color: Colors.blue,
                                ),
                              ),
                              didChangeCount: (count) {
                                setState(() {
                                  _counter = count;
                                });
                              },
                            ),
                          ),
                          Padding(
                            padding: const EdgeInsets.all(8.0),
                            child: CartStepperDouble(
                              value: _dCounter,
                              stepper: 0.01,
                              axis: Axis.vertical,
                              didChangeCount: (count) {
                                setState(() {
                                  _dCounter = (count * 100).round() / 100;
                                });
                              },
                            ),
                          ),
                        ],
                      ),
                    ],
                  ),
                ),
              ],
            ),
            const Center(
              child: Padding(
                padding: EdgeInsets.only(top: 25),
                child: Text('不同尺寸/设置颜色:'),
              ),
            ),
            Wrap(
              children: <Widget>[
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 20,
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 30,
                      style: const CartStepperStyle(
                        foregroundColor: Colors.red,
                        activeForegroundColor: Colors.white,
                        activeBackgroundColor: Colors.pinkAccent,
                        buttonAspectRatio: 1.5,
                      ),
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 30,
                      alwaysExpanded: true,
                      style: CartStepperStyle(
                        foregroundColor: Colors.black87,
                        activeForegroundColor: Colors.black87,
                        activeBackgroundColor: Colors.white,
                        border: Border.all(color: Colors.grey),
                        elevation: 0,
                        buttonAspectRatio: 1.5,
                      ),
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 30,
                      style: CartStepperStyle(
                        foregroundColor: Colors.black87,
                        activeForegroundColor: Colors.black87,
                        activeBackgroundColor: Colors.white,
                        border: Border.all(color: Colors.grey),
                        radius: const Radius.circular(8),
                        elevation: 0,
                        buttonAspectRatio: 1.5,
                      ),
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 30,
                      numberSize: 6,
                      format: NumberFormat('0000'),
                      style: const CartStepperStyle(
                        foregroundColor: Colors.red,
                        activeForegroundColor: Colors.white,
                        activeBackgroundColor: Colors.pinkAccent,
                        radius: Radius.zero,
                      ),
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8),
                  child: Center(
                    child: CartStepperInt(
                      value: _counter,
                      size: 80,
                      didChangeCount: (count) {
                        setState(() {
                          _counter = count;
                        });
                      },
                    ),
                  ),
                ),
              ],
            ),
            const Center(
              child: Padding(
                padding: EdgeInsets.only(top: 25),
                child: Text('限制最小值:'),
              ),
            ),
            Center(
              child: CartStepperInt(
                value: _counterLimit,
                style: CartStepperStyle.fromTheme(
                  Theme.of(context),
                  radius: const Radius.circular(3),
                ),
                size: 30,
                didChangeCount: (count) {
                  if (count < 1) {
                    ScaffoldMessenger.of(context).hideCurrentSnackBar();
                    ScaffoldMessenger.of(context).showSnackBar(const SnackBar(
                      content: Text('数量不能小于 1 哦~'),
                      backgroundColor: Colors.orangeAccent,
                    ));
                    return;
                  }
                  setState(() {
                    _counterLimit = count;
                  });
                },
              ),
            ),
            const SizedBox(height: 50)
          ],
        ),
      ),
    );
  }
}

通过以上代码,您可以根据需要调整和扩展cart_stepper插件的功能,以适应您的具体应用场景。希望这个帖子对您有所帮助!如果有任何问题或需要进一步的帮助,请随时提问。


更多关于Flutter购物车数量步进器插件cart_stepper的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter购物车数量步进器插件cart_stepper的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何在Flutter应用中使用cart_stepper插件来实现购物车数量步进器的示例代码。cart_stepper插件提供了一个用户友好的界面组件,用于增加或减少购物车中的商品数量。

首先,确保你已经在pubspec.yaml文件中添加了cart_stepper依赖:

dependencies:
  flutter:
    sdk: flutter
  cart_stepper: ^最新版本号  # 请替换为当前最新版本号

然后,运行flutter pub get来安装依赖。

接下来,你可以在你的Flutter应用中使用CartStepper组件。以下是一个完整的示例代码,展示如何在Flutter应用中使用CartStepper

import 'package:flutter/material.dart';
import 'package:cart_stepper/cart_stepper.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _quantity = 1;

  void _onQuantityChanged(int newValue) {
    setState(() {
      _quantity = newValue;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('购物车数量步进器示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '商品数量: $_quantity',
              style: TextStyle(fontSize: 24),
            ),
            SizedBox(height: 20),
            CartStepper(
              initialValue: _quantity,
              onValueChanged: _onQuantityChanged,
              min: 1,
              max: 100,
              step: 1,
              theme: CartStepperThemeData(
                iconColor: Colors.blue,
                activeColor: Colors.blueAccent,
                disabledColor: Colors.grey,
                borderColor: Colors.blueGrey,
              ),
            ),
          ],
        ),
      ),
    );
  }
}

在这个示例中:

  1. MyApp类定义了Flutter应用的基本结构和主题。
  2. MyHomePage是一个有状态的组件,用于管理购物车商品数量的状态。
  3. _quantity变量存储当前的商品数量。
  4. _onQuantityChanged方法是一个回调函数,当商品数量改变时被调用,并更新_quantity的值。
  5. CartStepper组件用于显示购物车数量步进器,它接受几个参数:
    • initialValue:初始值,即初始的商品数量。
    • onValueChanged:当数量改变时的回调函数。
    • minmax:允许的最小和最大数量。
    • step:每次增加或减少的数量。
    • theme:用于自定义步进器的主题,包括颜色等。

这个示例展示了如何使用cart_stepper插件创建一个简单的购物车数量步进器,并处理数量变化的事件。你可以根据需要进一步自定义和扩展这个示例。

回到顶部