Delar av dette innhaldet er ikkje tilgjengeleg på nynorsk enno.
- Accordion
- Alert
- Breadcrumbs
- Button
- Card
- Checkbox
- CheckboxGroup
- Chips
- DatePicker
- DescriptionList
- ErrorMessage
- ErrorSummary
- Fieldset
- FileUploader
- Footer
- Icon
- IconButton
- InlineButton
- Link
- LinkGroup
- MegaButton
- Modal
- NavigationTile
- OpenClose
- Pagination
- Panel
- Popover
- RadioGroup
- RolePicker
- ScrollToTopButton
- SearchField
- Select
- Spinner
- StepList
- Table
- Tabs
- Tag
- TextArea
- TextField
- TopBannerExternal
- TopBannerInternal
- Typografi
- Versjonshistorikk
TextField
Pakke: ds-forms
TextField (tekstfelt) er et felt hvor brukeren kan skrive inn korte tekster eller tall – som oftest brukt i et skjema.
Eksempel
Egnet til:
- korte svar i form av tekst eller tall.
- utfyllende svar (se mer under «Slik bruker du komponenten»)
- situasjoner der det er enklere for brukeren å skrive informasjon fremfor å velge den på annet vis.
Uegnet til:
- formatert tekst, for eksempel markdown.
Teknisk dokumentasjon
Se TextField i Storybook for tekniske detaljer.
Varianter
Størrelser
Komponenten kommer i to størrelsesvarianter:
- large brukes bare på eksterne flater. Komponenten får litt mer luft og tykkere ramme.
- medium kan brukes på både interne og eksterne flater.
Read-only
Slik bruker du komponenten
Vær generøs i hva du aksepterer av data. Godta input fra brukeren så lenge den er forståelig, for eksempel telefonnumre med mellomrom, kontonumre med punktum og e-postadresser med mellomrom til slutt.
Ledetekst, beskrivelse og hjelpetekst
Ja
Nei
Ikke bruk placeholder-tekst
Nei
Autocomplete
Bruk autocomplete
med aktuell verdi for felter med personlig informasjon som brukeren kan ha lagret for autoutfylling i nettleseren. For personlig innhold, for eksempel navn, adresse eller søk anbefaler vi å skru autocomplete på. For ikke-personlig innhold som for eksempel andre virksomheter, beløp, datoer og liknende anbefaler å skru autocomplete av, og dette er også standard oppførsel i tekstfeltet. Merk at de ulike nettleserne har varierende støtte for autocomplete.
Typer input
Bruk gjerne inputmode
som tilsvarer informasjonstypen du ber om tel
, search
, email
, og så videre. Disse tilbyr mobilbrukere et tastatur som er tilpasset inputtypen, men legg merke til at de kan også utløse validering av input i nettleseren (client-side validation).
God praksis
- Skriveregler for ledetekster og hjelpetekster.
- Beste praksis for obligatoriske felt.
Universell utforming
- Korte, tydelige og forståelige ledetekster er viktig. Hvis formatet er viktig, for eksempel. 9 siffer, bør dette vises i ledeteksten. Eksempel: Organisasjonsnummer (9 siffer).
- Kun placeholder-attributt er ikke tilstrekkelig for å bestå WCAG. Ledetekst (label/aria-label) og placeholder skal ikke være identiske. Placeholder-tekst er ment for å gi et hint om det som skal skrives i feltet.
- Feilmeldingen skal vises i umiddelbar nærhet til elementet den hører til. I Skatteetaten vises meldingen under tilhørende felt. Husk at kontrastkravet, minst 4,5 i kontrast for vanlig tekststørrelse, også gjelder på feilmeldinger (komponent oppfyller kravet som standard).