NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #918 most downloaded on pub.dev
Simple, reactive and highly customizable Flutter Dropdown with a lot of features (search, popups platform, async/sync,...) with multi mode like menu, dialog, bottomSheet and etc.
Last release 10 days ago
28 Sep 2026
Release timing varies
gaps range from 9 days to 1.5 years
Nearly every release is documented
notes for 54 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
81 releases · first in 2020
* [Breaking] bump sdk to 3.5.0
[Breaking] remove deprecated cacheExtent property
cacheExtent propertyscrollCacheExtent property to ListViewPropsOne column per quarter.
Add adaptive platform Ui feature: Material, Cupertino and Adaptive
Add adaptive platform Ui feature: Material, Cupertino and Adaptive
Add autocomplete new popup mode
add transitionBuilder, transitionDuration, reverseTransitionDuration to menuProps
transitionDuration: Duration(milliseconds: 500),
transitionBuilder: (context, animation, secondaryAnimation, child) {
return SlideTransition(
position: Tween<Offset>(
begin: const Offset(1, 0),
end: Offset.zero,
).animate(animation),
child: child,
);
}
add new property animationBuilder to DropdownButtonProps, examples of uses
/* Example 1: animation with only one icon ("iconClosed") like rotation */
animationBuilder: (child, isOpen) {
return AnimatedRotation(
turns: isOpen ? .5 : 0,
duration: Duration(milliseconds: 400),
child: child,
);
}
/* Example 2 : animation with two icons like switch */
dropdownButtonProps: DropdownButtonProps(
iconClosed: Icon(Icons.arrow_drop_down),
iconOpened: Icon(Icons.arrow_drop_up),
animationBuilder: (child, isOpen) {
return AnimatedSwitcher(
switchOutCurve: Curves.easeIn,
switchInCurve: Curves.easeIn,
duration: Duration(milliseconds: 400),
child: child,
);
},
)
add new property layoutDelegate to MenuProps and CupertinoMenuProps, you can extend
SingleChildLayoutDelegate
to create your own positioning strategy
example of use
layoutDelegate: (context, padding, position) => _PopupMenuRouteLayout(context, position)
class _PopupMenuRouteLayout extends SingleChildLayoutDelegate {
final RelativeRect position;
final BuildContext context;
const _PopupMenuRouteLayout(this.context, this.position);
@override
BoxConstraints getConstraintsForChild(BoxConstraints constraints) {
// pick any properties from the context to calculate proper constraints
final mediaQuery = MediaQuery.of(context);
final keyBoardHeight = mediaQuery.viewInsets.bottom;
final safeArea = mediaQuery.padding;
return BoxConstraints(/* calculate new constraints based on your needs */);
}
@override
Offset getPositionForChild(Size size, Size childSize) {
// The position where the child should be placed.
}
@override
bool shouldRelayout(covariant SingleChildLayoutDelegate oldDelegate) => false;
}
add SuggestionsProps to popupProps
add builder property for SuggestionsProps to override the hole suggestion widget
add properties to scrollView and wrap widget for selected items in multiSelection mode
Chips are fully customizable in multiSelection and suggestions
replace padding in searchFieldProps with containerBuilder
add onDisplayed callback to popupProps
add errorBuilder for InfiniteScrollProps
add possibility to reload item using myGlobalKey.currentState?.reloadItems(String filter) or
myGlobalKey.currentState?.loadMoreItems(String filter, int skip)
add textProps to have the ability to pass default text props through the context to
selectedItem
add new property for TextFieldProps
add the ability to listen to focus changes using onFocusChange
add new callbacks onBeforeClear and onClear to handle dropdown clear button action
onChanged to onSelectedPopupPropsMultiSelection changed to MultiSelectionPopupPropssuggestedItemsProps is placed inside SuggestionsPropsSemantics is removed from searchBox, to add it use containerBuilder like this you have
full access to Semantic properties.BottomSheet background
color 726Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
add Semantics to searchBox to support voiceOver/TalkBack ...
Nothing published for this version
add click properties to the dropdown
cacheItems for popupPropsonItemLoadedclearButton and dropdownButton
using direction propertyAsyncItems and items are replaced by items:(filter, infiniteScrollProps)isDisabled to itemBuilder paramsFavoriteItems renamed to SuggestedItemsisFilterOnline renamed to disableFilterselectionWidget renamed to checkBoxBuilderdropdownDecoratorProps renamed to decoratorPropsclearButtonProps and dropdownButtonProps are placed to suffixPropsNothing published for this version
add 'textDirection' in multiSelection mode to handle checkbox alignment
Nothing published for this version
add new properties to dropdownButton and clearDropdownButton: 'style', 'isSelected', ' selectedIcon', 'onPressed'
* Fix bugs * update Readme file
add interceptCallBacks for popupProps
interceptCallBacks for popupProps* Fix code format
Replace ScrollBar with RawScrollBar (adding new properties)
showClearButton into ClearButtonPropsdropdownDecoratorPropsIconButtonProps with DropdownButtonProps and ClearButtonProps for
clearButtonProps
and dropdownButtonPropscontainerBuilder to popup_propsisVisible prop to DropdownButtonPropsvalidationMultiSelectionWidget to validationWidgetBuilderfix fit issue in single Selection mode
isFilteredOnline to isFilterOnline
Breaking changes:
update readme.md
improve menu mode
improve dialog mode
fix large text in chips in multiSelection mode
fix bug 84
add new mode BOTTOM_SHEET
support Flutter v3
remove hint and label properties, use dropdownSearchDecoration instead
hint and label properties, use dropdownSearchDecoration insteadshowAsSuffixIcons property, now always are as suffixIconclearButtonSplashRadius' and 'clearButtonBuilder' into one property '
IconButtonProps'dropdownButtonSplashRadius' and 'dropdownButtonBuilder' into one property '
IconButtonProps'Nothing published for this version
add "popupCustomMultiSelectionWidget" option
add "isSelected" option to FavoriteItemsBuilder
* fix some bugs
new feature : change searchBox query programmatically using EditTextController
Nothing published for this version
Nothing published for this version
new feature : multiSelection mode
searchBoxDecoration removed: replaced by searchFieldProps _ autoFocusSearchBox removed : replaced by searchFieldProps _ searchBoxStyle removed : replaced by searchFieldProps _ searchBoxController removed : replaced by searchFieldProps
- showSelectedItem replaced by showSelectedItems
Nothing published for this version
Nothing published for this version
* fix analyser issues
prop that passes all props to search field
added property to set up the popup safe area
null safety issuesMigrating to null-safety @thx nizarhdt
Add onBeforeChange CallBack @thanks Vasiliy
suffixIcons adds an ability to switch icon management through the suffixIcon
of InputDecorationfix bug caused by last flutter SDK breaking changes #69
Invoke the dropdown programmatically
replace autoValidate by autoValidateMode
* fix bug
remove dropDownSearchDecoration duplication
dropDownSearchDecoration duplicationpopupBarrierColor featureadd popupItemDisabled feature, to manage popupItems accessibility
popupItemDisabled feature, to manage popupItems accessibilityhandle dropdownBuilder if item is Null
add dropdown icon customization
* manage default border color
fix issue: default selected item
* update description
* update description
* fix issue
make DropdownSearch as item of a form
Nothing published for this version
add autoFocus searchBox feature
Your coding agent can read these notes before it upgrades. Set up the MCP server →