- Når ErrorSummary vises setter komponenten automatisk tastaturfokus til toppen av oppsummeringen slik at skjermlesere får lest opp hele innholdet i den.
- Når du skal vise eller skjule komponenten må du bruke den innebyggede egenskapen (showErrorSummary) – i stedet for å lage egne regler rundt komponenten. Dette gjør det lettere for skjermleser å fange opp endringen.
- Feiloppsummeringen bruker id-er for å hoppe til stedene i skjemaet med feil. For at scrolling og fokus skal fungere, er det viktig at du gir skjemakomponentene en unik id, og henviser til disse når feilene oppstår.
- Overskriftsnivå kan settes for å passe inn i eksisterende hierarki.
- 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
ErrorSummary
Pakke: ds-forms
ErrorSummary (Feiloppsummering): Samlet visning av to eller flere feil i skjema eller stegliste.
Eksempel
Egnet til:
- å gi brukeren oversikt over flere feil før innsending.
- å hoppe direkte til felt med feil i et skjema.
Uegnet til:
- å vise lange (tekniske) feilkoder.
- å vise oppsummering av kun en feilmelding – bruk i stedet ErrorMessage
Teknisk dokumentasjon
Se ErrorSummary i Storybook for tekniske detaljer.
Slik bruker du komponenten
- Feiloppsummeringen plasseres som hovedregel over «Neste» eller «Send inn»-knapp i skjema eller stegliste - i umiddelbar nærhet til der hvor brukerens fokus er. Den skal ikke være synlig uten av bruker foretar seg noe, og først dukke opp etter en handling som utløser feil.
Feiloppsummering i stegliste:
- Gjenta tittelen til feltet med feil helt først eller tidlig i lenkene som peker til feilene. OBS: Tittelen trenger ikke gjentas i sin helhet, men det skal være mulig å forstå hvilket felt som feiler ut i fra teksten.
- For feilmeldinger som handler om enkle skrivefeil eller obligatoriske felt er korte tekster ok (for eksempel «Antall dager må fylles ut»). For lengre tekster med veiledning og forklaring anbefaler vi å bruke mer aktivt «du-språk».
- Du trenger ikke vise feiloppsummeringen hvis bare det bare er ett felt i steget som har feil og det er sannsynlig at brukeren får øye på feilmeldingen når hen trykker på nesteknappen.