cool_dropdown 2.1.0 cool_dropdown: ^2.1.0 copied to clipboard
Customizable cool dropdown UI You can customize selected item, BoxDecoration of the dropdownBox, and dropdown input.
Cool drop down #
Features #
-
All customizable style(font, fontsize. color, icon, result, dropdown decoration...).
-
Auto scroll to selected item position.
-
Dropdown is automatically placed. It's based on the position of the result on the screen(top/bottom).
-
Marquee effect.
-
Customizable animation.
-
Error handling.
-
"COOL"
Samples #
Installing #
command:
$ flutter pub add cool_dropdown
pubspec.yaml:
dependencies:
cool_dropdown: ^(latest)
Cool Dropdown options #
Option | Type | Default | Description |
---|---|---|---|
dropdownList | List<CoolDropdownItem | [] | Dropdown item list. |
defaultItem | CoolDropdownItem | null | Default item of the dropdown. |
onChange | Function(T) | required | When user selects one of the items, you will get T type value. |
onOpen | Function(bool) | null | When user either open or close the dropdown, you will get bool value. |
resultOptions | ResultOptions | - | |
dropdownOptions | DropdownOptions | - | Check below. |
dropdownItemOptions | DropdownItemOptions | - | Check below. |
dropdownTriangleOptions | DropdownTriangleOptions | - | Check below. |
dropdownController | DropdownController | required | Check below. |
Result Options(result<v1.3.0> -> ResultOptions<v.2.0.0>) #
Option | Type | Default | Description |
---|---|---|---|
width | double | 220 | |
height | double | 50 | |
space | double | 10 | Space between (label + icon) and arrow icon. |
padding | EdgeInsets | EdgeInsets.zero | |
alignment | Alignment | Alignment.center | Alignment of (label + icon). |
render | ResultRender | ResultRender.all | Set the order of the result elements to render. |
boxDecoration | BoxDecoration | BoxDecoration of the result box. | |
openBoxDecoration | BoxDecoration | BoxDecoration of when result box is open. | |
errorBoxDecoration | BoxDecoration | BoxDecoration of when result box is on error. | |
textStyle | TextStyle | TextStyle of the label in result box. | |
placeholderTextStyle | TextStyle | TextStyle of the placeholder in result box. | |
textOverflow | TextOverFlow | TextOverflow of the label in result box. | |
isMarquee | bool | false | A marquee effect when the label overflows. |
duration | Duration | Duration(milliseconds: 300) | When dropdown value is changed. |
marqueeDuration | Duration | Duration(milliseconds: 6000) | Duration of the marquee effect |
backDuration | Duration | Duration(milliseconds: 800) | Reverse animation duration of the marquee effect |
pauseDuration | Duration | Duration(milliseconds: 800) | Pause duration after marquee effect. |
Dropdown Options(dropdown<v1.3.0> -> dropdownOptions<v2.0.0>) #
Option | Type | Default | Description |
---|---|---|---|
width | double? | result width | Dropdown width. |
height | double | 50 | Dropdown height. |
top | double | 0 | Top position of the dropdown. |
left | double | 0 | Left position of the dropdown. |
color | Color | Colors.white | Dropdown color. |
borderRadius | BorderRadius | BorderRadius.all(Radius.circular(10)) | BorderRadius of the dropdown. |
shadow | List | [] | BoxShadow list of the dropdown. |
animationType | DropdownAnimationType | DropdownAnimationType.scale | Animation type of the dropdown. |
align | DropdownAlign | DropdownAlign.center | The alignment of the dropdown. If the dropdown and result box are different sizes, the dropdown will be aligned to the result box. |
align | SelectedItemAlign | SelectedItemAlign.center | The scroll alignment of the selected item in the dropdown. |
gap | DropdownGap | DropdownGap.zero | The gap between the dropdown and dropdown items. |
padding | EdgeInsets | EdgeInsets.zero | |
duration | Duration | Duration(milliseconds: 300) | Duration of the dropdown scroll animation. |
curve | Curve | Curves.easeInOut | Curve of the dropdown scroll animation. |
Dropdown Item Options(new) #
Option | Type | Default | Description |
---|---|---|---|
height | double | 50 | Dropdown item height. |
padding | EdgeInsets | EdgeInsets.symmetric(horizontal: 10) | Padding of the dropdown item. |
alignment | Alignment | Alignment.centerLeft | Vertical alignment of the dropdown item. |
mainAxisAlignment | MainAxisAlignment | MainAxisAlignment.start | Horizontal alignment of the dropdown item(label + icon). |
render | DropdownItemRender | DropdownItemRender.all | Set the order of the dropdown item elements to render. |
boxDecoration | BoxDecoration | BoxDecoration of the result box. | |
selectedBoxDecoration | BoxDecoration | BoxDecoration of when dropdown item is selected. | |
textStyle | TextStyle | TextStyle of the label in dropdown item. | |
selectedTextStyle | TextStyle | Selected TextStyle of the label in dropdown item. | |
textOverflow | TextOverFlow | TextOverflow of the label in dropdown item. | |
isMarquee | bool | false | A marquee effect when the label overflows. |
duration | Duration | Duration(milliseconds: 300) | When dropdown value is changed. |
marqueeDuration | Duration | Duration(milliseconds: 6000) | Duration of the marquee effect |
backDuration | Duration | Duration(milliseconds: 800) | Reverse animation duration of the marquee effect |
pauseDuration | Duration | Duration(milliseconds: 800) | Pause duration after marquee effect. |
Dropdown triangle options(new) #
Option | Type | Default | Description |
---|---|---|---|
width | double | 10 | Triangle width of the dropdown. |
height | double | 10 | Triangle height of the dropdown. |
left | double | 0 | Left position of the triangle. |
borderRadius | BorderRadius | 0 | BorderRadius of the triangle. |
align | DropdownTriangleAlign | DropdownTriangleAlign.center | Alignment of the triangle on the dropdown. |
Dropdown Controller(new) #
Option | Type | Default | Description |
---|---|---|---|
duration | Duration | Duration(milliseconds: 500) | Dropdown staggered animation duration. |
errorDuration | Duration | Duration(milliseconds: 500) | Result box decoration error animation duration. |
resultArrowInterval | Interval | Interval(0.0, 0.5, curve: Curves.easeOut) | Result arrow animation interval. |
resultBoxInterval | Interval | Interval(0.0, 0.5, curve: Curves.easeOut) | Result box animation interval. |
showDropdownInterval | Interval | Interval(0.5, 1.0, curve: Curves.easeOut) | Show dropdown animation interval. |
showErrorCurve | Curve | Curves.easeIn | Show error animation curve. |
open | method | - | Open the dropdown. |
close | method | - | Close the dropdown. |
error | method | - | Occur an error of the dropdown. |
resetError | method | - | Reset an error of the dropdown. |
resetValue | method | - | Reset the value of the dropdown. |