KasyKasy

Search Field Select

Viewer ao vivo e documentação do componente Search Field Select.

Sobre

Não existe um widget próprio de "SearchFieldSelect" — é o KasyDropDown (kasy_drop_down.dart) com searchable: true: um combobox que mostra um campo de busca no topo do painel e filtra as opções (por label e subtítulo) enquanto o usuário digita. Bom pra listas longas.

  • items: lista de KasyDropDownItem (value, label, icon, subtitle, enabled).
  • searchable: liga a busca ao vivo dentro do painel.
  • searchHint: placeholder do campo de busca (padrão "Search").
  • value / onChanged: seleção única. Existe também KasyDropDown.multiple (com values/onSelectionChanged) pra seleção múltipla, também combinável com searchable.
  • label / hint / description / errorText / isInvalid: mesmo vocabulário de campo de formulário do KasyTextField.
  • variant: estilo de preenchimento do gatilho (espelha KasyTextFieldVariant).
  • showSelectedCheck: mostra check na opção selecionada dentro do painel.
  • closeOnSelect: fecha o painel ao escolher (padrão true no single-select, false no multi-select).
  • maxPanelHeight: altura máxima do painel antes de rolar (padrão 280).

Nota: o gatilho reaproveita KasyTextField em modo somente leitura, e o painel flutua via OverlayPortal (não é um PopupMenu do Material), então herda o tema claro/escuro real do app.

Preview

Carregando o componente…

Atualizado em 03/11/2026

Nesta página