Important information

This page is not available in English.

ErrorSummary

[Missing text '/SelectionFactory/DesignStatus/empty' for 'English']

Pakke: ds-forms

ErrorSummary (Feiloppsummering): Samlet visning av to eller flere feil i skjema eller stegliste.

Eksempel

Eksempel på ErrorSummary

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: 

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.

Universell utforming  

  • 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.