AutoComplete

AutoComplete helps users type ahead against a fixed suggestion list while keeping free text in the bound value — entity lookup, tagging prep, or search fields where not every query matches an option.

For strict single- or multi-select without free text, use Combobox. For short native lists, use Select.

  • Search-as-you-type fields with a fixed option set
  • Entity lookup where typing narrows candidates
  • Forms where free text is allowed but suggestions speed entry
  • Bind a String signal via AutoCompleteBind.
  • Add AutoCompleteOption children for each suggestion.
  • Use events.on_select when the app needs a side effect on pick.
  • Set appearance.clear_after_select to reset the field after a pick, or blur_after_select to dismiss the list on selection.
Basic autocomplete

Type-to-filter suggestions appear in a list below the input as users narrow the option set.

Selection callback

on_select fires when a suggestion is picked so the app can react with side effects or logging.

Clear after select

Input resets after each pick—useful for quick repeated lookups without manual clearing.

Blur after select

Moves focus away from the input after pick to signal the entry flow is complete.

Disabled state

Blocks typing and selection when the field is unavailable in the current form context.

Keyboard list navigation

Arrow keys and Enter select options without leaving the keyboard—open the list, move, and confirm.

In field

AutoComplete nested in a Field with an associated label for standard form layouts.

Size matrix

Small and large input presets for dense toolbars versus prominent form fields.