Back to library

Autocomplete

Suggest common values as someone types while allowing a custom value.

Choose a suggestion or enter your own.

Recommended API

Property or elementTypeExample initial valueDescription
listMatching datalist IDGenerated per instanceLink the text field to native suggestions.
SuggestionsOption valuesDesign, Engineering, Marketing, Operations, ResearchProvide likely choices alongside free-form entry.

States

StateTriggerResult
suggestingType in the field.The browser can show matching suggestions.
filledChoose a suggestion or type your own value.The choice or custom text becomes the field value.

CSS variables

VariableTypeDefaultDescription
--q-textcolor #28302aMain text and foreground color.
--q-mutedcolor #70776fColor for secondary text.
--q-font-sizelength 13pxBase size for the component text.
--q-accentcolor #344e41Accent for active controls, indicators and focus.
--q-surfacecolor #ffffffSurface for controls and cards.
--q-bordercolor #dce0d8Color for outlines and dividers.
--q-radiuslength 10pxBase corner radius.
--q-gaplength calc(var(--q-space) * 2)Space between items, based on the spacing unit.
--q-control-pxlength calc(var(--q-space) * 4)Horizontal padding for controls.
--q-control-pylength calc(var(--q-space) * 2.5)Vertical padding for controls.
--q-spacelength 4pxBase unit for gaps and padding.