Multi Select
Søk, velg flere som chips, og opprett en ny på fri tekst — i én kontroll, bygget på cmdk.
import { MultiSelect } from '@/components/ui/MultiSelect'Retningslinjer
Bruk
Brukeren skal bygge opp et utvalg av flere elementer (mottakere, tagger, kategorier) med søk.
grupper for naturlige kategorier; creatable + validerNy for et «Opprett "x»-fallback på fritekst; hentTreff for server-søk. Gi kun én av alternativer/grupper/hentTreff.
Ikke bruk
Ikke for «velg ett og gå videre» — det er Autocomplete, som lukker og tømmer feltet ved valg.
Eksempler
Vis alt som
Statisk liste
React
Grupper
Alle beboere (42)
Creatable
Skriv noe som ikke finnes i listen — «Opprett …»-raden dukker opp.
Async søk
Deaktivert
Next.js
Sveip tabellen for å se hele innholdet
Navn
Type
Default
Beskrivelse
verdi *
Valg[]
—
Valgte chips (kontrollert). `Valg = { value, label, description?, disabled? }`.
onChange *
(verdi: Valg[]) => void
—
Kalles ved valg, fjerning og «Opprett ny».
alternativer
Valg[]
—
Statisk, ugruppert liste. Utelukkende med `grupper`/`hentTreff`.
grupper
ValgGruppe[]
—
Statisk, gruppert liste. `ValgGruppe = { heading, valg }`. Utelukkende med `alternativer`/`hentTreff`.
hentTreff
(query: string) => Promise<Valg[]>
—
Async søk, kalt rått på hvert tastetrykk. Overstyrer `alternativer`/`grupper`.
placeholder
string
—
Vist når ingen chips er valgt.
creatable
boolean
false
Vis «Opprett “x”»-raden for fritekst.
validerNy
(query: string) => boolean
—
Godkjenner fritekst for `creatable`. Utelatt: alt ikke-tomt godkjennes.
ariaLabel *
string
—
Tilgjengelig navn på feltet.
maxValgt
number
—
Maks antall chips. Videre (u-valgte) rader deaktiveres når taket er nådd.
tomTekst
string
'Ingen treff'
Tekst i tomtilstand-raden.
disabled
boolean
false
Deaktiverer feltet og chip-fjerning.
className
string
—
Ekstra klasser på feltets rot.

