Widgets 13 | DropdownButton
In this tutorial, you will learn how to use the DropdownButton in the flutter.
result
Before Start
Before starting our tutorial, I will create a page to contain our code.
1
import "package:flutter/material.dart";
2
import 'package:flutter_widgets/const/_const.dart';
3
​
4
class DropDownButtonPage extends StatefulWidget {
5
@override
6
_DropDownButtonState createState() => _DropDownButtonState();
7
}
8
​
9
class _DropDownButtonState extends State<DropDownButtonPage> {
10
@override
11
Widget build(BuildContext context) {
12
return Scaffold(
13
appBar: AppBar(
14
title: Text(PageName.DROP_DOWN_BUTTON),
15
),
16
body: SingleChildScrollView(
17
child: Column(
18
children: <Widget>[
19
//our code.
20
SizedBox(height: 600)
21
],
22
),
23
),
24
);
25
}
26
}
Copied!
It will show an empty page and I will put the code in the
children.
Simple Use
So let's look at our first simple about the
DropDownButton.1
DropdownButton _normalDown() => DropdownButton<String>(
2
items: [
3
DropdownMenuItem(
4
value: "1",
5
child: Text(
6
"First",
7
),
8
),
9
DropdownMenuItem(
10
value: "2",
11
child: Text(
12
"Second",
13
),
14
),
15
],
16
onChanged: (value) {
17
setState(() {
18
_value = value;
19
});
20
},
21
value: _value,
22
);
Copied!
When we click the button, it will show you in the picture as below. It is very useful to our
Constructor
As common, Let's look at the constructor of the
DropdownButton.1
DropdownButton({
2
Key key,
3
@required this.items,
4
this.value,
5
this.hint,
6
this.disabledHint,
7
@required this.onChanged,
8
this.elevation = 8,
9
this.style,
10
this.iconSize = 24.0,
11
this.isDense = false,
12
this.isExpanded = false,
13
})
Copied!
So let's look at the parameters step by step.
items
We have used this parameter above, but we don't really know it. When we see its definition, we know it is a list.
1
final List<DropdownMenuItem<T>> items;
Copied!
Then we look at the constructor of the
DropdownMenuItem. 1
const DropdownMenuItem({
2
Key key,
3
this.value,
4
@required this.child,
5
})
Copied!
You need to know that the
T is a common class, usually, it is the type of your data. Such as String, double. The value will be this class same as the T. The child will show in the menu. It is a widget, I use a Text in the fore example. In this example, I will use a Row to show you.1
DropdownButton _itemDown() => DropdownButton<String>(
2
items: [
3
DropdownMenuItem(
4
value: "1",
5
child: Row(
6
mainAxisAlignment: MainAxisAlignment.spaceBetween,
7
children: <Widget>[
8
Icon(Icons.build),
9
SizedBox(width: 10),
10
Text(
11
"build",
12
),
13
],
14
),
15
),
16
DropdownMenuItem(
17
value: "2",
18
child: Row(
19
mainAxisAlignment: MainAxisAlignment.spaceBetween,
20
children: <Widget>[
21
Icon(Icons.settings),
22
SizedBox(width: 10),
23
Text(
24
"Setting",
25
),
26
],
27
),
28
),
29
],
30
onChanged: (value) {
31
setState(() {
32
_value = value;
33
});
34
},
35
value: _value,
36
isExpanded: true,
37
);
Copied!
It will show you as follows. You should notice
isExpanded == true. It will expand the menu. When you click it, it will show you the right one.
But you should care about that the _value should be initiated with a valid value. In the above code, we have two choices,
1, 2. var _value = "1";If you set it to other value, such _value ="3".It will occur such error. 1
I/flutter ( 4147): 'package:flutter/src/material/dropdown.dart': Failed assertion: 'items == null ||
2
I/flutter ( 4147): value == null || items.where((DropdownMenuItem<T> item) => item.value == value).length == 1': is not
3
I/flutter ( 4147): true.
Copied!
hint&disabledHint
If you do not set value, it will show a widget in the default state. Let's look at the code with not setting the
value parameter.1
DropdownButton _hintDown() => DropdownButton<String>(
2
items: [
3
DropdownMenuItem<String>(
4
value: "1",
5
child: Text(
6
"First",
7
),
8
),
9
DropdownMenuItem<String>(
10
value: "2",
11
child: Text(
12
"Second",
13
),
14
),
15
],
16
onChanged: (value) {
17
print("value: $value");
18
},
19
hint: Text(
20
"Please select the number!",
21
style: TextStyle(
22
color: TEXT_BLACK,
23
),
24
),
25
);
Copied!
It will show you like this.
If we set
onChange or items to null, I will show the disabledHint.1
DropdownButton _hint2Down() => DropdownButton<String>(
2
items: null,
3
onChanged: null,
4
disabledHint: Text("You can't select anything."),
5
);
Copied!
style
In this part, I will give an example of many parameters, which are very easy to understand. These parameters are below.
1
this.elevation = 8,
2
this.style,
3
this.iconSize = 24.0,
4
this.isDense = false,
Copied!
So let's look at the example.
1
DropdownButton _normal2Down() => DropdownButton<String>(
2
items: [
3
DropdownMenuItem<String>(
4
value: "1",
5
child: Text(
6
"First",
7
),
8
),
9
DropdownMenuItem<String>(
10
value: "2",
11
child: Text(
12
"Second",
13
),
14
),
15
],
16
onChanged: (value) {
17
setState(() {
18
_value = value;
19
});
20
},
21
value: _value,
22
elevation: 2,
23
style: TextStyle(color: PURPLE, fontSize: 30),
24
isDense: true,
25
iconSize: 40.0,
26
);
Copied!
The
elevation controls the shadow of the menu, we have used it so many time, so I will not tell this again in the other widgets. The style controls the Text in the menu. The isDense will reduce the height of the button. The iconSize controls the size of the triangle-arrow. The result is below.
Conclusion
Today, we have learned the
DropdownButton. It just jumps out a menu to select. It is easy to understand, but need care about the value must be in the range of values of the items.Thanks for your reading!
The end.
Facebook Page
Twitter
GitHub
Medium
Last modified 3yr ago