A growing collection of widgets primarily used to step-through various steps/widgets or used as page indicators in an application.
A number of applications require to show steps to its users, for example, an app surveying its users require to display the step that the user is on while the user is filling up the survey form. This is where im_stepper comes into play with easy to use stepper widgets that may find its uses in myriad applications.
Simply import package:im_stepper/stepper.dart
and choose any of the following
steppers appropriate for your application:-
A simple to use icon stepper widget, wherein, each icon defines a step. Hence, total number of icons define total number of steps. Primarily designed to show steps as icons.
-
Important: IconStepper
direction
argument controls whether the stepper is displayed horizontally or vertically. A horizontal IconStepper 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. Same applies for the vertical IconStepper. -
IconStepper fires the
onStepReached(int index)
callback, which provides the index of the Step that is reached. This callback can be used to control the widget that appears when a certain step is reached. -
To customize the color, border, etc. of an IconStepper, simply wrap it inside a Container and specify the
decoration
argument. -
To enable validation before the next step is reached, set the
steppingEnabled
property to an appropriate value in aStatefulWidget
.
A simple to use image stepper widget, wherein, each image defines a step. Hence, total number of images define total number of steps. Primarily designed to show steps as images.
- Usage Note - See IconStepper Usage Note.
A simple and smooth dot stepper widget with built-in animations. Each dot in a DotStepper represents a step.
Shapes | Demo |
---|---|
Circle | |
Square | |
Rounded Rectangle | |
Line |
Effect | Demo |
---|---|
Trail | |
Slide | |
Magnify | |
Worm | |
Flat | |
Bullet | |
Jump |
- Important: It is important that a call to
goNext
andgoPrevious
is controlled by two variables in aStatefulWidget
with a call tosetState
in order for the DotStepper to work. Please look at the Example.
A simple to use number stepper widget, wherein, each number defines a step. Hence, total count of numbers define total number of steps. Primarily designed to show steps as numbers.
- Usage Note - See IconStepper Usage Note.
For any feedback please file an issue here.