Filter by Widgets


Stepper Widget

This Tutorials is posted by niebin312 at 04-03-2019 05:17:02



In this tutorial, you will learn how to use the Stepper in the flutter.

Before Start

We should create a page to contain our code.

import "package:flutter/material.dart";
import 'package:flutter_widgets/const/_const.dart';
class StepperPage extends StatefulWidget {
_StepperState createState() => _StepperState();
}
class _StepperState extends State<StepperPage> {
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(PageName.STEPPER),
),
body: SingleChildScrollView(
child: Column(
children: <Widget>[
//our code.
SizedBox(height: 600)
],
),
),
);
}
}

It shows an empty page with a title.

Simple Use

When I write this article, I have used some steps to describe our tutorials. In this situation, we can use a stepper to implement this.

Container(
color: RED,
child: Stepper(
steps: [
Step(
title: Text("Start"),
content: Text("Before starting, we should create a page."),
),
Step(
title: Text("Constructor"),
content: Text("Let's look at its construtor."),
),
],
),
),

It will show as follows.

Constructor

Let's look at its constructor. The steps is a list, onStepTapped, onStepContinue, onStepCancel,controlsBuilder are functions. The currentStep is the int. The type is the enum. I will tell the detail of them one by one.

Stepper({
Key key,
this.steps,
this.type = StepperType.vertical,
this.currentStep = 0,
this.onStepTapped,
this.onStepContinue,
this.onStepCancel,
this.controlsBuilder,
})

steps

Let's look at the definition of the steps.

final List<Step> steps;

Its constructor is below.

Step({
this.title,
this.subtitle,
this.content,
this.state = StepState.indexed,
this.isActive = false,
})

The title, subtitle, content are the widgets, the state is an enum.

So let's see an example.

Widget _steps() => Container(
margin: EdgeInsets.only(top: 10),
color: GREEN,
child: Stepper(
steps: [
Step(
title: Text("First"),
subtitle: Text("This is our first article"),
content: Text(
"In this article, I will tell you how to create a page."),
),
Step(
title: Text("Second"),
subtitle: Text("Constructor"),
content: Text("Let's look at its construtor."),
state: StepState.editing,
isActive: true),
Step(
title: Text("Third"),
subtitle: Text("Constructor"),
content: Text("Let's look at its construtor."),
state: StepState.error),
],
),
);

It will show you like this.

type

It has two types, the default value is the vertical. We use the horizontal in this example.

Widget _typeStep() => Container(
margin: EdgeInsets.only(top: 10),
constraints: BoxConstraints.expand(height: 200),
color: BLUE_LIGHT,
child: Stepper(
type: StepperType.horizontal,
steps: [
Step(
title: Text("First"),
content: Text("This is our first example."),
),
Step(
title: Text("Second"),
content: Text("This is our second example."),
),
],
),
);

It shows as follows.

onStepTapped&currentStep

In the fore example, when we click the second title, it doesn't show the content of the second. We need some handle.

Widget _tabStep() => Container(
margin: EdgeInsets.only(top: 10),
color: PURPLE,
child: Stepper(
steps: [
Step(
title: Text("First"),
content: Text("This is our first example."),
),
Step(
title: Text("Second"),
content: Text("This is our second example."),
),
Step(
title: Text("Third"),
content: Text("This is our third example."),
),
Step(
title: Text("Forth"),
content: Text("This is our forth example."),
),
],
currentStep: _index,
onStepTapped: (index) {
setState(() {
_index = index;
});
},
onStepCancel: () {
print("You are clicking the cancel button.");
},
onStepContinue: () {
print("You are clicking the continue button.");
},
),
);

When you click the third title, it will show as follows.

When you click the continue or cancel, it will print as follows.

I/flutter ( 6888): You are clicking the continue button.
I/flutter ( 6888): You are clicking the cancel button.

controlsBuilder

If you want to custom your own continue, cancel button, you can use the controlsBuilder to define them. The function is the same as the above. But this time, I will hide these two buttons.

Widget _builderStep() => Container(
margin: EdgeInsets.only(top: 10),
color: PURPLE,
child: Stepper(
steps: [
Step(
title: Text("First"),
content: Text("This is our first example."),
),
Step(
title: Text("Second"),
content: Text("This is our second example."),
),
Step(
title: Text("Third"),
content: Text("This is our third example."),
),
Step(
title: Text("Forth"),
content: Text("This is our forth example."),
),
],
currentStep: _index,
onStepTapped: (index) {
setState(() {
_index = index;
});
},
controlsBuilder: (BuildContext context,
{VoidCallback onStepContinue, VoidCallback onStepCancel}) =>
Container(),
),
);

It will hide these two buttons.

Conclusion

Today, we have learned the Stepper. It has many parameters, the most thing you should know that this widget is very special widget. You can learn it when you need time.

Thanks for your reading!

The end.

Whole code in GitHub,star to support.


0 Comments
Login to comment.
Recent Comments

Be the first to Comment. You can ask a Query or Share your toughts or Just say thanks.




Recent articles

Error: The name 'RangeSlider' is defined in the libraries 'package:flutter/src/material/range_slider.dart' and 'package:flutter_range_slider/src/flutter_range_slider.dart'.

Check out this article on Error: The name 'RangeSlider' is defined in the libraries 'package:flutter/src/material/range_slider.dart' and 'package:flutter_range_slider/src/flutter_range_slider.dart'.

Read full post

How to create a persistent bottom sheet in Flutter?

Check out this article on How to create a persistent bottom sheet in Flutter?

Read full post

How to draw a Decorative Horizontal line in Flutter?

Check out this article on How to draw a Decorative Horizontal line in Flutter?

Read full post

How to fetch an Image from Internet in Flutter

Check out this article on How to fetch an Image from Internet in Flutter

Read full post

ListView with Images from the Internet

Check out this article on ListView with Images from the Internet

Read full post

How to show Tooltip in Flutter?

Check out this article on How to show Tooltip in Flutter?

Read full post

How to create BottomNavigationBar in flutter?

Check out this article on How to create BottomNavigationBar in flutter?

Read full post

How to add actions to Appbar?

Check out this article on How to add actions to Appbar?

Read full post

How to open dart devtools in VS code?

Check out this article on How to open dart devtools in VS code?

Read full post

Accessibility features in flutter

Check out this article on Accessibility features in flutter

Read full post

© 2018 - Fluttercentral | Email to me - Seven.srikanth@gmail.com

Except as otherwise noted, this work is licensed under a Creative Commons Attribution 4.0 International License , and code samples are licensed under the BSD License.