NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #2490 most downloaded on pub.dev
A highly customizable, simple and easy to use AutoComplete widget for your Flutter app
Last release 7 months ago
16 Feb 2026
Release timing varies
gaps range from 9 days to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
101 releases · first in 2020
One column per quarter.
Nothing published for this version
[BREAKING] Fix: Issue: #256 Add maintainLabelSize to SearchInputDecoration (Requires Flutter 3.41.0 or greater)
[BREAKING] Fix: Issue: #256 Add maintainLabelSize to SearchInputDecoration (Requires Flutter 3.41.0 or greater)
fix(search): prevent RangeError when highlightIndex is out of bounds by @omar-hadek in #245
Full Changelog: v1.3.4...v1.4.0
Fix exceptions when using multiple instances of SearchField
Fix: FocusNode was not being disposed
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
Fix: Issue: #192 Exception: RangeError (index): Invalid value: Only valid value is 0: 1
fix(input_decoration): add missing visualDensity and semanticsService parameters for Flutter 3.35.1 compatibility by @iamtoricool in #250
Full Changelog: v1.3.3...v1.3.4
prepare for release v1.3.3
prepare for release v1.3.3
Full Changelog : v1.3.1...v1.3.2
Full Changelog: v1.3.1...v1.3.2
Add SearchInputDecoration.hint and SearchInputDecoration.maintainHintSize (Supports Flutter 3.32)
hint is deprecated, Use SearchInputDecoration.hintText instead.
Full Changelog : v1.3.0...v1.3.1
Full Changelog: v1.3.0...v1.3.1
Full Changelog : v1.2.9...v1.3.0
Full Changelog: v1.2.9...v1.3.0
Fix Issue: #232 add item padding and refactor decoration
Fix Issue: #233 Null exception when setting selectedValue to null
Nothing published for this version
Fix Issue: #218 FocusNode listener is not removed
Fix Issue: #222 Suggestion overlay dimensions not updated on resize
Fix Issue: #222 Suggestion overlay dimensions not updated on resize
Fix Issue: #224 calling setState in listener caused setState exception
Add VisualDensity Parameter to SearchInputDecoration
Fix Issue: #218 FocusNode listener is not removed
Allow onSearchTextChanged to serve Future Issue #215
Allow onSearchTextChanged to serve Future Issue #215
Dynamic height is broken when the suggestion direction is up Issue #216
allow onSearchTextChanged to serve Future Issue #215
Deprecate maintainHintHeight in favour of maintainHintSize property of SearchInputDecoration
Deprecate maintainHintHeight in favour of maintainHintSize property of SearchInputDecoration
Add hint property to SearchInputDecoration
fix: add value parameter to searchfield list item by @maheshj01 in #230
Full Changelog: v1.2.8...v1.2.9
Fix Issue: #212 add new parameter keepSearchOnSelection
Fix Issue: #228 add value parameter to searchfield list item
Full Changelog : v1.2.7...v1.2.8
Full Changelog: v1.2.7...v1.2.8
Refactor searchfield dimensions and offset calculation by @maheshj01 in #217
Full Changelog: v1.2.6...v1.2.7
Fix Range Error on First Suggestion Tap Issue #210
set overlay to null after unmount PR #209
Fix: Issue: #205 Index out of bound on SuggestionDirection.up
Fix: Issue: #204 Interactive text editable menu was not being displayed.
Fix: Issue: #197 Remove Null Checker
Fix: Issue: #197 Remove Null Checker
Add ScrollController to control the scroll of suggestions PR: #199
Fix: For SuggestionDirection.up arrow key would highlight in reverse.
Fix: Issue: #195 Add maintain Height property to SearchInputDecoration _Note: To use Searchfield 1.2.1 you would need flutter 3.27.0 or greater_
[Breaking]: Handle selected Value on Client Side Issue: #191
Before
The package sets the selectedValue automatically inside the component, which leads to issues when navigating or selecting suggestions
SearchField(
hint: 'Basic SearchField',
dynamicHeight: true,
maxSuggestionBoxHeight: 300,
initialValue: SearchFieldListItem<String>('ABC'),
suggestions: dynamicHeightSuggestion
.map(SearchFieldListItem<String>.new)
.toList(),
suggestionState: Suggestion.expand,
),
After
Now the client should handle the selectedValue explicitly in the client code (consumer code) by using the onSuggestionTap callback. This approach simplifies the API and provides more accurate control over the internal state of the package.
var selectedValue = SearchFieldListItem<String>('ABC');
SearchField(
hint: 'Basic SearchField',
dynamicHeight: true,
maxSuggestionBoxHeight: 300,
// now the selectedValue is handled by the client
onSuggestionTap: (SearchFieldListItem<String> item) {
setState(() {
selectedValue = item;
});
},
selectedValue: selectedValue, // rename initialValue to selectedValue
suggestions: dynamicHeightSuggestion
.map(SearchFieldListItem<String>.new)
.toList(),
suggestionState: Suggestion.expand,
),
Fixes: Issue: #178, Issue: #155
Fixes: Issue: #151 Clarifies use of SuggestionAction and now defaults to SuggestionState.unfocus without having to use FocusNode on client side.
Fixes: Issue: #190 Keyboard navigation does not work after selecting a suggestion.
Huge thanks to all contributors and supporters. Happy Thanksgiving! 🦃
[regression] Fix: Keyboard navigation does not work Issue: 183
Add contextmenubuilder property
contextmenubuilder propertyRefactor: Overlay condition too strict Issue: 182
Fix: new properties were missing in CopyWith Constructor Issue: 177 comment
remove custom assertions for SearchInputDecoration properties
SearchInputDecoration propertiesAdd new properties to SearchInputDecoration : prefixIconConstraints, hintMaxLines, floatingLabelStyle, errorText, error, hintTextDirection, hintFadeDu
SearchInputDecoration : prefixIconConstraints, hintMaxLines, floatingLabelStyle, errorText, error, hintTextDirection, hintFadeDuration, helper, suffixIconConstraintsFix SearchInputDecoration does not take any values Issue #176
add a SearchInputDecoration.copyWith constructor Issue #175
SearchInputDecoration.copyWith constructor Issue #175Adds following properties to SearchInputDecoration: suffix, label, suffixIconColor, prefix, prefixIconColor, prefixIcon and suffixIcon;
SearchInputDecoration: suffix, label, suffixIconColor, prefix, prefixIconColor, prefixIcon and suffixIcon;Adds new properties to style the search input using SearchInputDecoration: cursorColor, cursorWidth, cursorHeight, keyboardAppearance, cursorRadius, c
SearchInputDecoration: cursorColor, cursorWidth, cursorHeight, keyboardAppearance, cursorRadius, cursorOpacityAnimatesSearchInputDecoration following are the properties moved to SearchInputDecoration:
textCapitalization, searchStyleBefore
SearchField(
textCapitalization: TextCapitalization.words,
style: TextStyle(...)
...
)
After
SearchField(
searchInputDecoration: SearchInputDecoration(
textCapitalization: TextCapitalization.words,
style: TextStyle(...)
...
)
...
),
renamed dynamicHeightItem to dynamicHeight
dynamicHeightItem to dynamicHeightFixed Regression: Broke basic functionality to search hotfix #161
Fix: Scroll to selected Sugggestion Issue Fix: Issue #155
Option was not being selected on search Issue #136
Add Max Length and Option to disable counter for TextFormField #Issue 145
Fix: error when dealing with multiple Overlays Issue #143
Arrow keys now properly scroll to the focused suggestion
RawScrollbar to ScrollbarDecorationFix: onSuggestionTap returns empty searchKey usng keyboard Issue #138
emptyWidget was incorrectly displayed Fix Issue #132
ListView is always kept in state to maintain scrolloffset Issue #122
Incorrect search result passed to onSubmit Issue #126
Add elevation and shadowColor property to SuggestionDecoration class fixes Issue #110
elevation and shadowColor property to SuggestionDecoration class fixes Issue #110SuggestionDecoration.width propertytextAlign property to SearchField Completes PR #126(Expose onScroll event listener Issue #118
onScroll event listener Issue #118showEmpty parameter to hide/show emptyWidgetAdd hoverColor and selectionColor property to SuggestionDecoration. Issue #112
hoverColor and selectionColor property to SuggestionDecoration. Issue #112[BREAKING] Remove deprecated property comparator, use onSearchTextChanged instead
comparator, use onSearchTextChanged instead- Fix SuggestionDirection broken
Update Suggestion dimensions on Window resize Issue #84
Expose onTap callback to get the tap event on the searchfield
Clip Suggsestions within Material, Fixes issue #44
add onTapOutside callback to SearchField Issue #94
onTapOutside callback to SearchField Issue #94autofocus property to SearchField Issue #105Your coding agent can read these notes before it upgrades. Set up the MCP server →