Drop Down

SobreCopiar link da âncora

Dropdown do design system (HeroUI "Select"). Seleção única por padrão; use KasyDropDown.multiple para escolher vários valores (o painel fica aberto, cada linha selecionada mostra um check, o gatilho resume as escolhas).

• items: lista de KasyDropDownItem<T> (value, label, icon opcional, subtitle opcional, enabled).
• value / onChanged: seleção única (modo padrão).
• values / onSelectionChanged / multiSummary: seleção múltipla (KasyDropDown.multiple); multiSummary customiza o texto resumido no gatilho.
• label / hint / showRequiredIndicator: rótulo acima do campo, placeholder e asterisco de obrigatório.
• description / errorText / isInvalid: texto de apoio, mensagem de erro (some a description) e força o estilo inválido.
• enabled: desabilita e esmaece o gatilho.
• leadingIcon: ícone dentro do campo.
• variant: estilo de preenchimento do gatilho (espelha KasyTextFieldVariant).
• focusBorder: se o gatilho pinta a borda "ativa" enquanto o painel está aberto.
• showSelectedCheck: mostra o check à direita do item selecionado no painel.
• searchable / searchHint: adiciona campo de busca no topo do painel que filtra por rótulo e subtítulo.
• 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 internamente.
• Gatilho reaproveita o KasyTextField em modo somente leitura (herda label, borda, sombra e foco do kit); o painel é um OverlayPortal ancorado ao gatilho, não um PopupMenuButton do Material — evita o clássico menu branco no dark mode.

PreviewCopiar link da âncora

Atualizado em 03/11/2026