fl_select 0.7.1

A customizable Flutter select widget for building filter bars, cascading menus, and pickers with single/multiple selection, async loading, theming, and i18n.

0.7.1

• FEATURE showSelect now accepts optional leading, trailing and centerTitle widgets to attach to the header row, mirroring showModalBottomSelect. Both entries now share a common SelectHeader widget that lays the title out with an outer Stack so the title stays truly centered across the full header width even when leading / trailing are asymmetrical.

0.7.0

• BREAKING make PopupSelectBar.selectDelegates required — it is now a non-nullable List<SelectDelegate> and must be provided to PopupSelectBar. PopupSelectBar.onApplied is likewise now required (PopupSelectBarResultCallback, non-nullable). Update call sites that previously omitted either parameter to pass them explicitly.

• BREAKING make PopupSelectButton.selectDelegate required — it is now a non-nullable SelectDelegate and must be provided to every PopupSelectButton constructor. PopupSelectButton.onApplied is likewise now required (PopupSelectButtonResultCallback, non-nullable). Update call sites that previously omitted either parameter to pass them explicitly.

• BREAKING make SelectDelegate.entriesLoader required — it is now a non-nullable Future<SelectEntries> Function() and must be provided by every delegate. SelectView.onChanged is likewise now required (SelectCallback, non-nullable). Update call sites that previously omitted either parameter to pass them explicitly.

• BREAKING remove all deprecated aliases, parameters, getters and methods introduced in 0.5.0 by the Select* / PopupSelect* renaming. This includes: the Selector*Entry* / SelectorEntries aliases, SelectorBox, showSelector, showModalBottomSelector, SelectorTheme / SelectorThemeData, SelectorPanelTheme, SelectorDelegate / CascadingSelectorDelegate / ListSelectorDelegate / GridSelectorDelegate / FlattenSelectorDelegate, SelectorController / SelectorControllerProvider, SelectorCallback, SelectorLayout / SelectorListLayout / SelectorGridLayout / SelectorChipLayout / SelectorRangeLayout, SelectorLocalizations / SelectorLocalizationsDelegate, SelectorLabelLoader / SelectorLabelState, DropdownOverlayStyle, kSelectorListTileHeight, the DropdownSelector* → PopupSelect* aliases (DropdownSelectorBar, DropdownTab, DropdownSelectController, DropdownTabData, DropdownSelectControllerProvider, DropdownSelectorBarTheme, DropdownSelectorButton, DropdownSelectorButtonTheme, DropdownSelectorButtonVariant, DropdownSelectorButtonResultCallback, DropdownSelectorButtonWillToggleCallback, kDropdownSelectorButtonHeight, DropdownSelectorDirection), and the selectorDelegates / selectorTheme / selectorDelegate parameters and getters, previousSelectorDelegate, selectorController and attachSelectorDelegates members. Use the Select* / PopupSelect* names instead; see the Migration guide for the full old → new tables.

• DEPRECATION rename the selector lifecycle callbacks on PopupSelectBar and PopupSelectButton — onSelectorShowed / onSelectorHidden / onSelectorWillShow / onSelectorWillHide → onSelectShowed / onSelectHidden / onSelectWillShow / onSelectWillHide. The old names are retained as deprecated constructor parameters and getters that delegate to the new names (passing both at the same call site triggers an assertion) and will be removed in a future minor version.

• DEPRECATION rename PopupSelectController.hideSelector → hideSelect, toggleSelector → toggleSelect, and isSelectorShowing → isSelectShowing to drop the redundant Selector wording. The old names are retained as deprecated methods / getters that delegate to the new names and will be removed in a future minor version.

• FEATURE FlattenSelect now consumes SelectCategoryEntry.layout via an exhaustive switch (layout), matching the behavior already present in ListSelect / GridSelect. Each category's right-side content renders as a SelectListView, SelectGridView, SelectChipBar, SelectRangeView, or SelectCounter depending on its layout, with the grid/list/counter/range layout-specific parameters (crossAxisCount, spacing, childAspectRatio, toText, etc.) and the delegate theme overrides (grid/field/chip) honored. When layout is null, it falls back to the grid using the widget's own crossAxisCount / mainAxisSpacing / crossAxisSpacing / childAspectRatio, so existing default behavior is unchanged.