A fully customizable, beautiful and easy to use stepper widgets with different variations.
The stepper widgets help you to show or collect information from users using organized steps.
In the pubspec.yaml
of your flutter project, add the following dependency:
dependencies:
easy_stepper: <latest_version>
In your library add the following import:
import 'package:easy_stepper/easy_stepper.dart';
-
Simply import
package:easy_stepper/easy_stepper.dart
. -
Important: The
direction
argument controls whether the stepper is displayed horizontally or vertically. A horizontal Stepper can be wrapped within a Column with no issues. However, if wrapped within a row, it must also be wrapped within the built-in Expanded widget. The same applies to the vertical Stepper. -
Validation: To enable validation before the next step is reached, set the
steppingEnabled
property to an appropriate value in aStatefulWidget
. -
Controlling Steppers: All steppers are controlled using the
activeStep
property. You can control a stepper by tapping individual steps.- See examples here.
-
To customize the color, border, etc., wrap a stepper widget inside a
Container
and specify it'sdecoration
argument.
Example:
EasyStepper(
activeStep: activeStep,
lineLength: 70,
stepShape: StepShape.rRectangle,
stepBorderRadius: 15,
borderThickness: 2,
padding: 20,
stepRadius: 28,
finishedStepBorderColor: Colors.deepOrange,
finishedStepTextColor: Colors.deepOrange,
finishedStepBackgroundColor: Colors.deepOrange,
activeStepIconColor: Colors.deepOrange,
loadingAnimation: 'assets/loading_circle.json',
showLoadingAnimation: true,
steps: const [
EasyStep(
icon: Icon(Icons.add_task_rounded),
title: 'Order Placed',
),
EasyStep(
icon: Icon(Icons.category_rounded),
title: 'Preparing',
),
EasyStep(
icon: Icon(Icons.local_shipping_rounded),
title: 'Shipping',
),
EasyStep(
icon: Icon(Icons.door_back_door_outlined),
title: 'On The Way',
),
EasyStep(
icon: Icon(Icons.check_circle_outline_outlined),
title: 'Delivered',
),
EasyStep(
icon: Icon(Icons.reviews_outlined),
activeIcon: Icon(Icons.reviews_rounded),
title: 'Add Review',
),
],
onStepReached: (index) => setState(() => activeStep = index),
),
Simple to use icon stepper widget, wherein each icon defines a step. Hence, the total number of icons represents the total number of available steps. See Example.
- With Title:
- Without Title:
- With Line Text:
- Round Rectangle Border:
Feel free to contribute to this project.
If you find a bug or want a feature, but don't know how to fix/implement it, please fill an issue.
If you fixed a bug or implemented a feature, please send a pull request.