Intro
Select viser brukeren en nedtrekksliste der ett alternativ kan velges. Et valg kan ikke fjernes, kun byttes med et annet alternativ. Komponenten bruker native HTML-<select>.
Eksempler
Small brukes på interne flater der det er behov for et mer komprimert grensesnitt.
Readonly-attributtet gjør at verdien ikke kan endres. Til forskjell fra disabled-felter vil brukere fortsatt kunne tabbe til det, og feltet vil inkluderes når skjemaet sendes inn.
Vi fraråder bruk av disabled state. Vurder om du trenger å vise feltet i det hele tatt, om du heller kan bruke 'readOnly', eller bare kan skrive det ut i ren tekst.
Skjule label visuelt
Select skal alltid ha en label. I spesielle tilfeller kan label skjules visuelt med propen hideLabel
, f.eks. i tabeller der feltet får ledeteksten sin fra tabellheaderen. Selv om labelen skjules er det viktig at den er meningsfull siden den fortsatt leses av skjermlesere.
Retningslinjer
Antall alternativer
Select funker godt når det er 7 eller flere alternativer. Om det er færre alternativer vil det i skjemaer være enklere for brukerne å forholde seg til Radio. Vurder også om det er behov for å søke i eller filtrere alternativene. Da anbefaler vi å bruke Combobox.
Plassering av label og description
Label og description er alltid plassert over feltet slik at det er godt synlig på små skjermer og ikke kommer i konflikt med feilmelding.
Unngå labeltekst som går over to linjer.
Tilpass bredden
Skjemafelter bør ha en bredde som er tilpasset det brukeren skal fylle inn. Når feltene har forskjellig bredde blir det lettere å navigere i skjemaer med mange felter.
Uegnet til navigasjon
Bruk av Select til navigasjon kan være brudd på WCAG 3.2.2 On Input, som sier at endring av et skjemafelt ikke skal føre til endring av kontekst. Legg merke til at det å endre URLen ikke nødvendigvis innebærer endring av kontekst.
Relevante lenker
Tilgjengelighet
Tastaturinteraksjon
Select fungerer ikke med VoiceOver i Chrome på Mac. Dette er en kjent feil med VoiceOver.
Kommando | Interaksjon |
---|---|
Space | Åpne listen (på Mac også velge alternativ i listen) |
Enter | Velge alternativ i listen (i Windows også åpne listen) |
↓ | Markere neste alternativ i listen |
↑ | Markere forrige alternativ i listen |
Home | Markere første element i listen |
End | Markere siste element i listen |
Tegn | Hopper til det første alternativet som starter på tegnene |
Disabled
Vi fraråder bruk av disabled state. Vurder om du trenger å vise feltet i det hele tatt, om du heller kan bruke readOnly, eller bare kan skrive ut informasjonen i ren tekst.
Figma
I Figma er nedtrekslisten (options) et eksempel du kan bruke til prototyping. I kode er dette et native element som operativsystemet bestemmer designet på.
Props
Select
children
- Type:
ReactNode
- Description:
htmlSize?
- Type:
number
- Description:
style?
- Type:
CSSProperties
- Description:
label
- Type:
ReactNode
- Description:
hideLabel?
- Type:
boolean
- Description:
error?
- Type:
ReactNode
- Description:
errorId?
- Type:
string
- Description:
size?
- Type:
"medium" | "small"
- Description:
disabled?
- Type:
boolean
- Description:
description?
- Type:
ReactNode
- Description:
id?
- Type:
string
- Description:
readOnly?
- Type:
boolean
- Description:
className?
- Type:
string
ref?
- Type:
LegacyRef<HTMLSelectElement>
- Description:
Tokens
Token | Fallback |
---|---|
--ac-select-bg | --a-surface-default |
--ac-select-text | --a-text-default |
--ac-select-border | --a-border-default |
--ac-select-hover-border | --a-border-action-hover |
--ac-select-active-border | --a-border-action-selected |
--ac-select-error-border | --a-surface-danger |