NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #916 most downloaded on pub.dev
A highly customizable typeahead (autocomplete) text input field for Flutter
Last release 6 months ago
04 Apr 2026
Ships unpredictably
gaps range from 8 days to 2.2 years
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
77 releases · first in 2018
Highlighted suggestion in controller
constrainWidth parameter for suggestions boxhideWithKeyboard parameter (use hideOnUnfocus)flutter_keyboard_visibility dependencypointer_interceptor dependencychore: increase version
chore: increase version
SuggestionsController.refreshOne column per quarter.
Returning null from suggestionsCallback hides the box
suggestionsCallback hides the boxshowOnFocus parameter for TypeAheadField to allow not showing the box on focusgainFocus paramater for SuggestionsController.open to allow opening the box without focusingUpgraded flutter_keyboard_visibility: ^5.4.1 to ^6.0.0
SetState error in suggestions box
Custom TextField builder via the builder property, replacing TextFieldConfiguration .
TextField builder via the builder property, replacing TextFieldConfiguration.decorationBuilder property for customizing SuggestionsBox decoration.SuggestionsController.SuggestionsController for notification of selected suggestions.SuggestionsBoxController to SuggestionsController.layoutArchitecture to listBuilder.noItemsFoundBuilder to emptyBuilder.onSuggestionSelected to onSelected.suggestionsBoxVerticalOffset to offset, now including horizontal offset.hideSuggestionsOnKeyboardHide to hideWithKeyboard.keepSuggestionsOnSuggestionSelected to hideOnSelect and inverted its functionality.keepSuggestionsOnLoading to retainOnLoading.SuggestionsBoxDecoration, replaced by decorationBuilder.TextFieldConfiguration, replaced by custom TextField builder.CupertinoSuggestionsBoxController in favor of SuggestionsController.TypeAheadFormFiled, replaced by custom TextField builder.intercepting parameter (now always true).onSuggestionsBoxToggle parameter (replaced with subscriptions to SuggestionsController).ignoreAccessibleNavigation parameter (no longer required with new Overlay code).animationStart parameter (use animation mapping).minCharsForSuggestions parameter (implement in client code).autoFlipListDirection parameter (use listBuilder).General cleanup of the codebase
expands property to TextFieldConfiguration
itemSeparatorBuilder to Material TypeAheadFormField
itemSeparatorBuilder to Material TypeAheadFormField (#500)Issue with scrollbar click-through
Support for alternative layouts of results, such as Grid
Removed top padding on scrollbar
itemSeparatorBuilder option (#489)autofillHints properties (#489)onTapOutside callback to typeahead
onTapOutside callback to typeahead (#486)autoFlipMinHeight option (#468)Incorrect vertical offset calculation of suggestion box for Flutter mobile web
### Changed - Updated the changelog file
Visibility of Cupertino decoration and formatted code
Visibility of suggestions box classes
Improved the main example for better readability on pub.dev
Applied PR to fix onSelected issue introduced in Flutter 3.7.0
onSelected issue introduced in Flutter 3.7.0Updated SDK level to 2.19.0 for Flutter 3.7.0
Used maybeOf for scrollable to prevent exceptions in Flutter
maybeOf for scrollable to prevent exceptions in Flutter (#47)Issues with web platforms and arrow keys
Null safety to suggestions box controller
hideKeyboardOnDrag option (#22)Warnings related to Flutter 3.0
Reverted previous fix for Flutter 3.0 warnings
Issue of suggestions not hiding on close
Deprecated maxLengthEnforced property
maxLengthEnforced property (#83)Resizing issue before opening the suggestion box
Deprecated information in example
suggestionsCallback is called (#49)textAlignVertical (#44)maxLines nullable (#54)Scrollcontroller as an optional parameter
Scrollcontroller as an optional parameter (#27)ErrorBuilder Widget (#35)Scrollbar ScrollController issue
ScrollController issue (#25)Allowed suggestionsCallback to return null
suggestionsCallback to return null (#08)Missing size guard in _adjustMaxHeightAndOrientation
_adjustMaxHeightAndOrientation (#03)### Fixed - Styling of CHANGELOG.md
autoFillHints for TextFieldConfiguration
autoFillHints for TextFieldConfiguration (#95)### Changed - Null-safety pre-release
### Changed - Re-applied changes from 1.9.2 - Types for some calls
Reverted back to settings of 1.9.1; changes in 1.9.2 will be part of 2.0.0
Removed unneeded typecasts and added String types
Changed default setting to disabled for autovalidateMode and fixed typo
autovalidateMode and fixed typo (#256)hideKeyboard property to handle edge cases where text field has focus
hideKeyboard property to handle edge cases where text field has focus (#238)enabled and autovalidateMode properties (#248)enableSuggestions to TextField Configuration (#249)flutter_keyboard_visibility to version 4.X (#255)Fixed typos and updated validator tests and examples to remove deprecated constants
### Fixed - Fixed dispose() error in tests
dispose() error in tests### Fixed - Fixed "flashing" bug
Updated flutter_Keyboard_visibility dependency to ^3.0.0
flutter_Keyboard_visibility dependency to ^3.0.0Erratic suggestions callback behaviour
Addressed keyboard visibility issues (contribution from @alphamikle)
### Fixed - Various issues
onTap property to TextFieldConfiguration
onTap property to TextFieldConfigurationoffsetX property to SuggestionsBoxDecoration and CupertinoSuggestionsBoxDecorationenableInteractiveSelection property
enableInteractiveSelection propertykeyboard_visibility dependencyonChanged now properly triggers for TypeAheadFormField
onChanged now properly triggers for TypeAheadFormFieldCupertinoTypeAheadField for Cupertino users
CupertinoTypeAheadField for Cupertino userssuggestionsBoxController property and SuggestionsBoxController class for manual control
suggestionsBoxController property and SuggestionsBoxController class for manual controltextDirection property to TextFieldConfigurationWidth parameters in BoxConstraints are now respected in SuggestionsBoxDecoration
BoxConstraints are now respected in SuggestionsBoxDecorationautoFlipDirection property for automatic direction flipping of the suggestions list when space is limited
autoFlipDirection property for automatic direction flipping of the suggestions list when space is limitedLimited the number of suggestionsCallbacks until the current call is finished
suggestionsCallbacks until the current call is finished### Changed - Optimizations ### Fixed - Various issues
Property keepSuggestionsOnLoading for maintaining suggestions during loading
keepSuggestionsOnLoading for maintaining suggestions during loadingProperty hideSuggestionsOnKeyboardHide to control suggestions box behavior
hideSuggestionsOnKeyboardHide to control suggestions box behaviorSuggestions no longer called on TextBox focus
Your coding agent can read these notes before it upgrades. Set up the MCP server →