Drop Down

Preview

About

Design-system dropdown (HeroUI "Select"). Single selection by default; use KasyDropDown.multiple to pick several values (the panel stays open, each selected row shows a check, and the trigger summarizes the choices).

• items: list of KasyDropDownItem<T> (value, label, optional icon, optional subtitle, enabled).
• value / onChanged: single selection (default mode).
• values / onSelectionChanged / multiSummary: multiple selection (KasyDropDown.multiple); multiSummary customizes the summarized text shown on the trigger.
• label / hint / showRequiredIndicator: label above the field, placeholder, and required asterisk.
• description / errorText / isInvalid: helper text, error message (replaces description), and forces the invalid style.
• enabled: disables and dims the trigger.
• leadingIcon: icon inside the field.
• variant: the trigger's fill style (mirrors KasyTextFieldVariant).
• focusBorder: whether the trigger paints the "active" border while the panel is open.
• showSelectedCheck: shows the check to the right of the selected item in the panel.
• searchable / searchHint: adds a search field at the top of the panel that filters by label and subtitle.
• closeOnSelect: closes the panel on selection (defaults to true for single-select, false for multi-select).
• maxPanelHeight: maximum panel height before it scrolls internally.
• The trigger reuses KasyTextField in read-only mode (inheriting the kit's label, border, shadow, and focus behavior); the panel is an OverlayPortal anchored to the trigger, not a Material PopupMenuButton — this avoids the classic white menu in dark mode.

Last updated on 08/23/2026