KasyKasy

Search Field Select

Live preview and documentation for the Search Field Select component.

Preview

componentPreview.loading

About

There's no dedicated "SearchFieldSelect" widget — it's KasyDropDown (kasy_drop_down.dart) with searchable: true: a combobox that shows a search field at the top of the panel and filters the options (by label and subtitle) as the user types. Good for long lists.

  • items: list of KasyDropDownItem (value, label, icon, subtitle, enabled).
  • searchable: turns on live search inside the panel.
  • searchHint: placeholder for the search field (default "Search").
  • value / onChanged: single selection. There's also KasyDropDown.multiple (with values/onSelectionChanged) for multi-select, which can also be combined with searchable.
  • label / hint / description / errorText / isInvalid: same form-field vocabulary as KasyTextField.
  • variant: fill style of the trigger (mirrors KasyTextFieldVariant).
  • showSelectedCheck: shows a check mark on the selected option inside the panel.
  • closeOnSelect: closes the panel on pick (default true for single-select, false for multi-select).
  • maxPanelHeight: max panel height before it scrolls (default 280).

Note: the trigger reuses KasyTextField in read-only mode, and the panel floats via OverlayPortal (not a Material PopupMenu), so it inherits the app's real light/dark theme.

Last updated on 08/23/2026

On this page