A material design button for selecting from a list of items.
A dropdown button lets the user select from a number of items. The button shows the currently selected item as well as an arrow that opens a menu for selecting another item.
Requires one of its ancestors to be a Material widget.
See also:
- DropdownButtonHideUnderline, which prevents its descendant drop down buttons from displaying their underlines.
- RaisedButton, FlatButton, ordinary buttons that trigger a single action.
- material.google.com/components/buttons.html#buttons-dropdown-buttons
- Inheritance
- Object
- Widget
- StatefulWidget
- DropdownButton
Constructors
- DropdownButton({Key key, @required List<DropdownMenuItem<T>> items, T value, Widget hint, @required ValueChanged<T> onChanged, int elevation: 8, TextStyle style, double iconSize: 24.0, bool isDense: false })
-
Creates a dropdown button.
Properties
- elevation → int
-
The z-coordinate at which to place the menu when open.
read-only - hint → Widget
-
Displayed if value is null.
read-only - iconSize → double
-
The size to use for the drop-down button's down arrow icon button.
read-only - isDense → bool
-
Reduce the button's height.
read-only - items → List<DropdownMenuItem<T>>
-
The list of possible items to select among.
read-only - onChanged → ValueChanged<T>
-
Called when the user selects an item.
read-only - style → TextStyle
-
The text style to use for text in the dropdown button and the dropdown menu that appears when you tap the button.
read-only - value → T
-
The currently selected item, or null if no item has been selected. If value is null then the menu is popped up as if the first item was selected.
read-only - hashCode → int
-
Get a hash code for this object.
read-only, inherited - key → Key
-
Controls how one widget replaces another widget in the tree.
read-only, inherited - runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Operators
-
operator ==(
other) → bool -
The equality operator.
inherited
Methods
-
createState(
) → _DropdownButtonState<T> -
Creates the mutable state for this widget at a given location in the tree.
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited -
debugFillDescription(
List<String> description) → void -
Add additional information to the given description for use by toString.
inherited -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed.
inherited -
toString(
) → String -
Returns a string representation of this object.
inherited -
toStringShort(
) → String -
A short, textual description of this widget.
inherited