TabNavSelectDelegate class

A tab-nav (top-navigation) select for category data.

Category tabs on top drive which category's children are shown below, laid out by the category's layout (defaulting to defaultLayout, then to a 3-column grid). When only one category is available, the tab bar is hidden.

The tabs represent the top category level only, so the top level must be SelectCategoryEntry roots; how deep a category's content goes is decided by its layout — SelectListLayout / SelectGridLayout / SelectWrapLayout / SelectCounterLayout / SelectRangeLayout render one level, while SelectCascadingLayout drills down into nested children.

Inheritance

Constructors

TabNavSelectDelegate({SelectLayout? defaultLayout, ToggleWidgetBuilder? checkboxBuilder, ToggleWidgetBuilder? radioBuilder, SelectItemBuilder? itemBuilder, bool isScrollable = false, SelectionMode selectionMode = SelectionMode.single, SelectEntries? entries, Future<SelectEntries> entriesLoader()?, SelectEntries? selectedEntries, SelectEntries? selectedEntriesLoader()?, SelectEntries? resetEntries, SelectEntries? resetEntriesLoader()?, SelectActionBarBuilder? actionBarBuilder, Color? selectedColor, Color? onSelectedColor, Color? backgroundColor, Color? onBackgroundColor, Color? backgroundColorHigh, Color? backgroundColorHighest, Color? onBackgroundColorHighest, String? resetText, String? applyText, bool searchEnabled = false, SelectSearchPredicate? searchPredicate, String? searchHintText, Duration searchDebounceDuration = const Duration(milliseconds: 300), SelectSearchBarTheme? searchBarTheme, SelectActionBarTheme? actionBarTheme, SelectSideBarTheme? sideBarTheme, SelectTabBarTheme? tabBarTheme, SelectGridTileTheme? gridTileTheme, SelectListTileTheme? listTileTheme, SelectFieldTileTheme? fieldTileTheme, SelectExpansionTileTheme? expansionTileTheme, SelectChipBarTheme? chipBarTheme, SelectWrapViewTheme? wrapViewTheme, SelectCascadingViewTheme? cascadingViewTheme, SelectRangeSliderTheme? rangeSliderTheme, SelectPanelTheme? panelTheme, WidgetBuilder? skeletonBuilder, Widget errorBuilder(Object error, StackTrace? stackTrace)?})

Properties

actionBarBuilder → SelectActionBarBuilder?
Optional builder to customize the action bar UI.
finalinherited
actionBarTheme → SelectActionBarTheme?
Theme overrides for the action bar widget.
finalinherited
applyText → String?
finalinherited
asyncEntries → Future<SelectEntries>?
The selectable entries future, lazily initialized on first access from entries (wrapped in Future.value) or entriesLoader.
no setterinherited
backgroundColor → Color?
Base background color used by the select panel.
finalinherited
backgroundColorHigh → Color?
A higher-contrast background color used for elevated sections.
finalinherited
backgroundColorHighest → Color?
The highest-contrast background color (often used for nested levels).
finalinherited
cascadingViewTheme → SelectCascadingViewTheme?
Theme overrides for the cascading view.
finalinherited
checkboxBuilder → ToggleWidgetBuilder?
Optional custom checkbox widget builder.
final
chipBarTheme → SelectChipBarTheme?
Theme overrides for the selected chips bar.
finalinherited
defaultLayout → SelectLayout?
The layout used by categories that leave their layout null, defaulting to a 3-column grid (SelectGridLayout(crossAxisCount: 3)) when null.
final
entries → SelectEntries?
The full selectable entries supplied synchronously, if any.
no setterinherited
entriesLoader → Future<SelectEntries> Function()?
Fetches the full selectable entries for this select.
finalinherited
errorBuilder → Widget Function(Object error, StackTrace? stackTrace)?
Optional builder invoked when entriesLoader fails to load.
finalinherited
expansionTileTheme → SelectExpansionTileTheme?
Theme overrides for expansion tiles.
finalinherited
fieldTileTheme → SelectFieldTileTheme?
Theme overrides for range field tiles.
finalinherited
gridTileTheme → SelectGridTileTheme?
Theme overrides for grid tiles.
finalinherited
hashCode → int
The hash code for this object.
no setterinherited
hasSyncEntries → bool
Whether the entries were supplied synchronously via entries, as opposed to an entriesLoader.
no setterinherited
isScrollable → bool
Whether the category tab bar can be scrolled horizontally.
final
itemBuilder → SelectItemBuilder?
Optional builder that fully replaces each child item's widget.
final
listTileTheme → SelectListTileTheme?
Theme overrides for list tiles.
finalinherited
onBackgroundColor → Color?
Text/icon color used on top of backgroundColor.
finalinherited
onBackgroundColorHighest → Color?
Text/icon color used on top of backgroundColorHighest.
finalinherited
onSelectedColor → Color?
Text/icon color used on top of selectedColor.
finalinherited
panelTheme → SelectPanelTheme?
Theme overrides for the panel's elevation, shadow and shape decoration.
finalinherited
radioBuilder → ToggleWidgetBuilder?
Optional custom radio widget builder.
final
rangeSliderTheme → SelectRangeSliderTheme?
Theme overrides for range sliders in range fields.
finalinherited
resetEntries → SelectEntries?
The reset selection entries, lazily initialized from resetEntriesLoader on first access, or the value passed to the constructor.
no setterinherited
resetEntriesLoader → SelectEntries? Function()?
Returns the selection that should be used when "Reset" is tapped.
finalinherited
resetText → String?
finalinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
searchBarTheme → SelectSearchBarTheme?
Theme overrides for the search bar.
finalinherited
searchDebounceDuration → Duration
The debounce delay before filtering entries after the search text changes.
finalinherited
searchEnabled → bool
Whether the search bar is visible in the select panel.
finalinherited
searchHintText → String?
Hint text shown in the search bar when the input is empty.
finalinherited
searchPredicate → SelectSearchPredicate?
Custom predicate used to match entries against a search query.
finalinherited
selectedColor → Color?
The background color used for selected entries.
finalinherited
selectedEntries ↔ SelectEntries?
The previously selected entries to restore.
getter/setter pairinherited
selectedEntriesLoader → SelectEntries? Function()?
Returns the previously selected entries to restore.
finalinherited
selectionMode → SelectionMode
The panel-wide selection mode.
finalinherited
sideBarTheme → SelectSideBarTheme?
Theme overrides for the side bar (vertical category bar).
finalinherited
skeletonBuilder → WidgetBuilder?
Optional builder for the loading skeleton.
finalinherited
tabBarTheme → SelectTabBarTheme?
Theme overrides for the tab bar (horizontal category bar).
finalinherited
wrapViewTheme → SelectWrapViewTheme?
Theme overrides for the wrap view.
finalinherited

Methods

buildBody(BuildContext context, List<SelectEntry> entries, Set<SelectEntry>? selectedEntries, {String searchQuery = ''}) → Widget
Builds the select body widget.
override
buildError(BuildContext context, Object error, StackTrace? stackTrace) → Widget
Builds the error widget shown when entriesLoader fails to load.
inherited
buildSkeleton(BuildContext context) → Widget
Builds the loading skeleton.
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited