Frivio

Design

Autocomplete

Chromet for «nedtrekk med søk»: felt + resultatliste med full piltastnavigasjon og en ekte WAI-ARIA-combobox.

import { Autocomplete } from '@/components/ui/Autocomplete'

Retningslinjer

Bruk

  • Brukeren skal søke i en dynamisk eller lang liste og velge ett treff.

  • Søk-logikk og debounce eies av kallstedet — onQuery kalles rått per tastetrykk.

Ikke bruk

  • Ikke for «velg én av et lite, fast sett» — bruk Dropdown eller PillTabs/Select.

  • Ikke bygg en ny «søk med nedtrekk»-kopi — BrregSearch er alt bygget oppå denne.

Eksempler

Vis alt som

Søk i en lokal liste

Laster (busy)

Med etikett og ikon

Ikonet sentreres mot feltet.

Deaktivert

Sveip tabellen for å se hele innholdet

Navn
Type
Default
Beskrivelse
value *
string
—
Feltverdien (kontrollert).
onQuery *
(query: string) => void
—
Kalles rått på hvert tastetrykk. Debounce/minstelengde er kallstedets ansvar.
results *
T[]
—
Treffene som vises i panelet.
renderItem *
(item: T, meta: { active: boolean; index: number }) => ReactNode
—
Rendrer innholdet i én rad. Padding/layout er kallstedets.
onSelect *
(item: T, index: number) => void
—
Kalles når en rad velges (klikk eller Enter).
itemKey
(item: T, index: number) => string | number
indeks
React-nøkkel per rad. Sett når resultatene har en ekte id.
placeholder
string
—
Plassholdertekst i feltet.
busy
boolean
false
Viser en spinner til høyre i feltet.
tomTekst
string
—
Tekst vist når feltet er fokusert, ikke tomt og results er tom. Utelatt: ingen tomtilstand-rad.
footer
ReactNode
—
Ekstra rad(er) nederst, alltid synlig når panelet er åpent — for et «legg til uten oppslag»-fallback. Primitivet holder fokus i feltet når raden trykkes, så kallstedet trenger ikke noe eget blur-vern.
icon
ReactNode
—
Ledende ikon inni feltet.
endAdornment
ReactNode
—
Ekstra innhold til høyre i feltet, etter en evt. busy-spinner.
label
string
—
Synlig etikett over feltet (videreført til Input).
ariaLabel
string
—
Tilgjengelig navn når label mangler.
id
string
—
Felt-id. Default: generert.
disabled
boolean
—
Deaktiverer feltet.
autoFocus
boolean
—
Fokuserer feltet ved mount.
className
string
—
Ekstra klasser på feltets wrapper.

Regler

regel/ett-element-tegner-fokus

Beslektede