searchfield
A highly customizable, simple and easy to use AutoComplete widget for your Flutter app
2.0.0
21K downloads/mo
#2146 most downloaded on pub.dev
maheshj01/searchfield
What this package is like to depend on
Last release 6 months ago
16 Feb 2026
Release timing varies
gaps range from 9 days to 4 months
Nearly every release is documented
notes for 88 of 88 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
101 releases · first in 2020
5 releases in the last 12 months
see the full history below
Release timeline
101 releases · Dec 2020 to Feb 2026Releases
latest 60 of 101-
2.0.1-dev.116 Feb 2026 pre-releaseNothing published for this version
-
2.0.015 Feb 2026Release notes
Open source →[BREAKING] Fix: Issue: #256 Add maintainLabelSize to SearchInputDecoration (Requires Flutter 3.41.0 or greater)
Release notes
Open source →- [BREAKING] Fix: Issue: #256 Add maintainLabelSize to SearchInputDecoration (Requires Flutter 3.41.0 or greater)
-
1.4.002 Nov 2025Release notes
Open source →What's Changed
- fix(search): prevent RangeError when highlightIndex is out of bounds by @omar-hadek in #245
New Contributors
- @omar-hadek made their first contribution in #245
Full Changelog: v1.3.4...v1.4.0
Release notes
Open source →-
Fix exceptions when using multiple instances of SearchField
-
Fix: FocusNode was not being disposed
-
1.4.0-dev.502 Nov 2025 pre-releaseNothing published for this version
-
1.4.0-dev.402 Aug 2025 pre-releaseNothing published for this version
-
1.4.0-dev.323 May 2025 pre-releaseNothing published for this version
-
1.4.0-dev.216 May 2025 pre-releaseNothing published for this version
-
1.4.0-dev.113 May 2025 pre-releaseNothing published for this version
-
1.3.531 Aug 2025Release notes
Open source →- Fix: Issue: #192 Exception: RangeError (index): Invalid value: Only valid value is 0: 1
-
1.3.422 Aug 2025Release notes
Open source →What's Changed
- fix(input_decoration): add missing visualDensity and semanticsService parameters for Flutter 3.35.1 compatibility by @iamtoricool in #250
New Contributors
- @iamtoricool made their first contribution in #250
Full Changelog: v1.3.3...v1.3.4
-
1.3.302 Aug 2025Release notes
Open source →- Fix: SuggestionDirection.flexible was not updating direction on widget update
-
1.3.223 May 2025Release notes
Open source →-
Add SearchInputDecoration.hint and SearchInputDecoration.maintainHintSize (Supports Flutter 3.32)
-
hint is deprecated, Use SearchInputDecoration.hintText instead.
-
-
1.3.116 May 2025 -
1.3.013 May 2025Release notes
Open source →-
Fix Issue: #232 add item padding and refactor decoration
-
Fix Issue: #233 Null exception when setting selectedValue to null
-
-
1.3.0-dev.605 May 2025 pre-releaseNothing published for this version
-
1.3.0-dev.504 May 2025 pre-release -
1.3.0-dev.403 May 2025 pre-releaseRelease notes
Open source →-
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
-
-
1.3.0-dev.316 Apr 2025 pre-releaseRelease notes
Open source →-
Allow onSearchTextChanged to serve Future Issue #215
-
Dynamic height is broken when the suggestion direction is up Issue #216
-
-
1.3.0-dev.212 Apr 2025 pre-release -
1.3.0-dev.119 Mar 2025 pre-releaseRelease notes
Open source →-
Deprecate maintainHintHeight in favour of maintainHintSize property of SearchInputDecoration
-
Add hint property to SearchInputDecoration
-
-
1.2.905 May 2025Release notes
Open source →What's Changed
- fix: add value parameter to searchfield list item by @maheshj01 in #230
- add new parameter keepSearchOnSelection by @maheshj01 in #229
Full Changelog: v1.2.8...v1.2.9
Release notes
Open source →-
Fix Issue: #212 add new parameter keepSearchOnSelection
-
Fix Issue: #228 add value parameter to searchfield list item
-
1.2.803 May 2025 -
1.2.716 Apr 2025Release notes
Open source →What's Changed
- Refactor searchfield dimensions and offset calculation by @maheshj01 in #217
- Allow onSearchTextChanged to serve Future Issue #215
- Dynamic height is broken when the suggestion direction is up Issue #216
- set overlay to null after unmount PR #209
Full Changelog: v1.2.6...v1.2.7
-
1.2.612 Mar 2025 -
1.2.511 Mar 2025 -
1.2.428 Jan 2025 -
1.2.326 Jan 2025Release notes
Open source →- Fix: Issue: #204 Interactive text editable menu was not being displayed.
-
1.2.225 Dec 2024Release notes
Open source →-
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.
-
-
1.2.112 Dec 2024Release notes
Open source →- 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
Release notes
Open source →- 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
-
1.2.029 Nov 2024Release notes
Open source →- [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.unfocuswithout having to useFocusNodeon client side. -
Fixes: Issue: #190 Keyboard navigation does not work after selecting a suggestion.
Huge thanks to all contributors and supporters. Happy Thanksgiving! 🦃
Release notes
Open source →- [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! 🦃
-
1.1.925 Nov 2024 -
1.1.818 Nov 2024 -
1.1.722 Oct 2024 -
1.1.626 Sep 2024Release notes
Open source →- Fix: new properties were missing in CopyWith Constructor Issue: 177 comment
Release notes
Open source →- Fix: new properties were missing in CopyWith Constructor Issue: 177 comment
-
1.1.525 Sep 2024 -
1.1.424 Sep 2024Release notes
Open source →- Add new properties to
SearchInputDecoration:prefixIconConstraints,hintMaxLines,floatingLabelStyle,errorText,error,hintTextDirection,hintFadeDuration,helper,suffixIconConstraints
Release notes
Open source →- Add new properties to SearchInputDecoration : prefixIconConstraints , hintMaxLines , floatingLabelStyle , errorText , error , hintTextDirection , hintFadeDuration , helper , suffixIconConstraints
- Add new properties to
-
1.1.321 Sep 2024 -
1.1.220 Sep 2024Release notes
Open source →- add a
SearchInputDecoration.copyWithconstructor Issue #175 - Fix Issue #174 Exception: RangeError (index): Index out of range: index must not be negative: -1
- Fix Issue #165 Trigger onSubmit when a option is not selected.
Release notes
Open source →-
add a SearchInputDecoration.copyWith constructor Issue #175
-
Fix Issue #174 Exception: RangeError (index): Index out of range: index must not be negative: -1
-
Fix Issue #165 Trigger onSubmit when a option is not selected.
- add a
-
1.1.114 Sep 2024Release notes
Open source →- Adds following properties to
SearchInputDecoration:suffix,label,suffixIconColor,prefix,prefixIconColor,prefixIconandsuffixIcon; - Fix Issue #166: select suggestion with keyboard throws null error
- Fix Issue: 168: update selected item when the suggestions change
Release notes
Open source →-
Adds following properties to SearchInputDecoration : suffix , label , suffixIconColor , prefix , prefixIconColor , prefixIcon and suffixIcon ;
-
Fix Issue #166 : select suggestion with keyboard throws null error
-
Fix Issue: 168 : update selected item when the suggestions change
- Adds following properties to
-
1.1.010 Sep 2024Release notes
Open source →- Adds new properties to style the search input using
SearchInputDecoration:cursorColor,cursorWidth,cursorHeight,keyboardAppearance,cursorRadius,cursorOpacityAnimates - [BREAKING] Input deocration properties are now part of
SearchInputDecorationfollowing are the properties moved toSearchInputDecoration:textCapitalization,searchStyle
Before
SearchField( textCapitalization: TextCapitalization.words, style: TextStyle(...) ... )After
SearchField( searchInputDecoration: SearchInputDecoration( textCapitalization: TextCapitalization.words, style: TextStyle(...) ... ) ... ),Release notes
Open source →-
Adds new properties to style the search input using SearchInputDecoration : cursorColor , cursorWidth , cursorHeight , keyboardAppearance , cursorRadius , cursorOpacityAnimates
-
[BREAKING] Input deocration properties are now part of SearchInputDecoration following are the properties moved to SearchInputDecoration : textCapitalization , searchStyle
Before
SearchField( textCapitalization: TextCapitalization.words, style: TextStyle(...) ... )
After
SearchField( searchInputDecoration: SearchInputDecoration( textCapitalization: TextCapitalization.words, style: TextStyle(...) ... ) ... ),
- Adds new properties to style the search input using
-
1.0.905 Aug 2024Release notes
Open source →- renamed
dynamicHeightItemtodynamicHeight - Fix exception on scroll (debug) Issue #162
Release notes
Open source →-
renamed dynamicHeightItem to dynamicHeight
-
Fix exception on scroll (debug) Issue #162
- renamed
-
1.0.823 Jul 2024 -
1.0.722 Jul 2024Release notes
Open source →- Fix: Scroll to selected Sugggestion Issue Fix: Issue #155
- Fix: maxSuggestionInViewport did not show correct number of suggestions.
- Add Support for dynamic height of suggestionItem Issue #67
Release notes
Open source →-
Fix: Scroll to selected Sugggestion Issue Fix: Issue #155
-
Fix: maxSuggestionInViewport did not show correct number of suggestions.
-
Add Support for dynamic height of suggestionItem Issue #67
-
1.0.610 Jul 2024 -
1.0.505 Jun 2024Release notes
Open source →- Add Max Length and Option to disable counter for TextFormField #Issue 145
Release notes
Open source →- Add Max Length and Option to disable counter for TextFormField #Issue 145
-
1.0.404 Jun 2024 -
1.0.328 May 2024Release notes
Open source →- Arrow keys now properly scroll to the focused suggestion
- Fix: Scrollbar tap hides the suggestions Issue #137
- Expose additional properties of
RawScrollbartoScrollbarDecoration
Release notes
Open source →-
Arrow keys now properly scroll to the focused suggestion
-
Fix: Scrollbar tap hides the suggestions Issue #137
-
Expose additional properties of RawScrollbar to ScrollbarDecoration
-
1.0.223 May 2024 -
1.0.122 Mar 2024Release notes
Open source →- emptyWidget was incorrectly displayed Fix Issue #132
- adds animationDuration to customize the list animation duration
- Scroll to bottom and top of list using alt+down and alt+up keys
Release notes
Open source →-
emptyWidget was incorrectly displayed Fix Issue #132
-
adds animationDuration to customize the list animation duration
-
Scroll to bottom and top of list using alt+down and alt+up keys
-
1.0.020 Mar 2024Release notes
Open source →- ListView is always kept in state to maintain scrolloffset Issue #122
- Shift+Tab should respect sequence of SearchField in a form with SuggestionState.hidden Issue #125
Release notes
Open source →-
ListView is always kept in state to maintain scrolloffset Issue #122
-
Shift+Tab should respect sequence of SearchField in a form with SuggestionState.hidden Issue #125
-
0.9.913 Mar 2024 -
0.9.813 Mar 2024Release notes
Open source →- Add
elevationandshadowColorproperty to SuggestionDecoration class fixes Issue #110 - Customize width of suggestions using
SuggestionDecoration.widthproperty - Initial Value should be selected by default Issue #127
- Add
textAlignproperty to SearchField Completes PR #126(
Release notes
Open source →-
Add elevation and shadowColor property to SuggestionDecoration class fixes Issue #110
-
Customize width of suggestions using SuggestionDecoration.width property
-
Initial Value should be selected by default Issue #127
-
Add textAlign property to SearchField Completes PR #126 (
- Add
-
0.9.709 Mar 2024Release notes
Open source →- Expose
onScrollevent listener Issue #118 - Add
showEmptyparameter to hide/show emptyWidget
Release notes
Open source →-
Expose onScroll event listener Issue #118
-
Add showEmpty parameter to hide/show emptyWidget
- Expose
-
0.9.606 Mar 2024Release notes
Open source →- Add
hoverColorandselectionColorproperty to SuggestionDecoration. Issue #112
Release notes
Open source →- Add hoverColor and selectionColor property to SuggestionDecoration. Issue #112
- Add
-
0.9.506 Mar 2024Release notes
Open source →- Add keyboard support for suggestions Issue #7
- [BREAKING] Remove deprecated property
comparator, useonSearchTextChangedinstead
Release notes
Open source →-
Add keyboard support for suggestions Issue #7
-
[BREAKING] Remove deprecated property comparator , use onSearchTextChanged instead
-
0.9.207 Feb 2024 -
0.9.107 Feb 2024Release notes
Open source →-
Update Suggestion dimensions on Window resize Issue #84
-
Adds a enum SuggestionDirection.flexible to position the suggestions based on the available space. Issue #56
-
-
0.9.008 Dec 2023Release notes
Open source →- Expose onTap callback to get the tap event on the searchfield
- Add autoValidateMode property to SearchField
-
0.8.923 Nov 2023 -
0.8.821 Nov 2023Release notes
Open source →- add
onTapOutsidecallback to SearchField Issue #94 - add
autofocusproperty to SearchField Issue #105
Release notes
Open source →-
add onTapOutside callback to SearchField Issue #94
-
add autofocus property to SearchField Issue #105
- add