Komponenter

Fejlopsummering

Fejlopsummeringer bruges til at give overblik over fejl eller mangler, der skal rettes på en side eller et trin, før brugeren kan komme videre.

Åbn dette eksempel i et nyt vindue

Sådan bruges komponenten

Anvendes til

Vis en fejlopsummering når der er fejl i noget af det brugeren har indtastet, også hvis der kun er én fejl på siden.

Vejledning

Opsummeringen vises øverst på siden/trinnet under headeren, men over sidens/trinnets øverste overskrift. Fejlopsummeringen indeholder alle de fejlmeddelelser, der måtte være på siden/trinnet, således at brugeren kan navigere direkte til de fejl og mangler, der skal rettes.

Der skal være links i fejlopsummeringen til de steder på siden, hvor fejlene er. Når der trykkes på et link i opsummeringen, skal fokus flyttes til det felt fejlmeddelelsen knytter sig til.

Sørg for at linkene i fejlopsummeringen er identiske med fejlmeddelelsen de linker til.

For fejl i et enkeltstående felt, skal du linke direkte til feltet.

Når en bruger skal indtaste svar i flere felter, fx dag-, måned- og årsfelterne i datofelter, skal du linke til det første felt, der indeholder en fejl.

Hvis du ikke ved, hvilket felt der indeholder en fejl, skal du linke til det første felt i gruppen af felter.

For fejl, der kræver, at en bruger skal vælge en eller flere ting på en liste ved hjælp af en radioknap eller en tjekboks, skal du linke til den første radioknap eller tjekboks på listen.

Placering

Sæt fejlopsummeringen øverst på siden. Hvis din side indeholder en brødkrumme eller et tilbage-link, skal du placere den under disse, men over titlen (den øverste overskrift) på siden.

Åbn dette eksempel i et nyt vindue

Gå til eksemplets kode

Sådan (do)

Eksempel på, hvordan en fejlmeddelelse kan se ud

Sådan: Indsæt fejlmeddelelser over det felt, hvor fejlen skal rettes, samt øverst på siden. Brug farven rød til både fejlmeddelelser og til at markere, hvor fejlen er (Wroblewski, 2008, s. 119-132). Farven rød signalerer i computersystemer "alarm", "fare", "problem", "fejl" osv. (Johnson, 2010, s. 72) og er den farve, det menneskelige øje ser bedst (Johnson, 2010, s. 54).

Ikke sådan (don't)

Eksempel på, hvordan en fejlmeddelelse ikke bør se ud

Ikke sådan: Undgå, at fejlmeddelelsen kun optræder ét sted på siden. Nogle brugere vil ikke få øje på den. Undgå også, at fejlen kun vises på én måde – fx med farve (Wroblewski, 2008, s. 119-133). Undgå så vidt muligt at bruge den røde farve til andet end fejlmeddelelser (Johnson, 2010, s. 57).

Se komponenten i eksempelløsninger

Referencer

Luke Wroblewski: Web Form Design: Filling in the Blanks (2008)
Jeff Johnson: Designing with the Mind in Mind, Second Edition (2014)

Installation

HTML Struktur

<nav aria-labelledby="error-summary-example">

    <div class="alert alert-error mt-0 mb-8" role="alert" data-module="error-summary">
        <svg class="icon-svg alert-icon" aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <div class="alert-body">
            <h2 class="alert-heading" id="error-summary-example">Der er problemer</h2>
            <ul class="alert-text nobullet-list">
                <li><a class="function-link" href="#date-field-year">Datoen for udløbsdato på
                        dit pas bør inkludere årstal</a></li>
                <li><a class="function-link" href="#zipcode-field">Indtast postnummer - fx
                        4000</a></li>
            </ul>
        </div>
    </div>

</nav>

Indsættes over formularen, men under h1 overskriften.

Hver fejl tilføjes til <ul> listen med et anchor link til feltet der er omtalt således at fokus flyttes til pågældende felt.

Placering

Vis dette eksempel i et nyt vindue

<nav aria-labelledby="error-form-example">

    <div class="alert alert-error mt-0 mb-8" role="alert" data-module="error-summary">
        <svg class="icon-svg alert-icon" aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <div class="alert-body">
            <h2 class="alert-heading" id="error-form-example">Der er problemer</h2>
            <ul class="alert-text nobullet-list">
                <li><a class="function-link" href="#example-name-error">Skriv dit fulde navn,
                        og adskil for- og efternavne med mellemrum, fx Anders Andersen</a>
                </li>
                <li><a class="function-link" href="#checkboxes-error-option1">Angiv om du er
                        dansk, svensk eller anden nationalitet</a></li>
                <li><a class="function-link" href="#date-input-error-day">Datoen kan ikke være
                        i fremtiden</a></li>
            </ul>
        </div>
    </div>

</nav>
<h1 id="oplysninger-om-dig">Oplysninger om dig</h1>
<form novalidate>

    <div class="form-group form-error">
        <label class="form-label" for="example-name-error">Hvad er dit fulde navn?</label>

        <span class="form-error-message" id="example-name-error-error">
            <span class="sr-only">Fejl: </span>Skriv dit fulde navn, og adskil for- og
            efternavne med mellemrum, fx Anders Andersen
        </span>

        <input type="text" id="example-name-error" name="example-name-error"
            class="form-input" aria-invalid="true"
            aria-describedby="example-name-error-error " required autocomplete="name">
    </div>

    <div class="form-group form-error">
        <fieldset aria-describedby="checkboxes-error-error">
            <legend class="form-label">
                Hvad er din nationalitet?
            </legend>

            <span class="form-error-message" id="checkboxes-error-error">
                <span class="sr-only">Fejl: </span>Angiv om du er dansk, svensk eller anden
                nationalitet
            </span>

            <div class="form-group-checkbox">
                <input type="checkbox" id="checkboxes-error-option1" name="nationalitet[]"
                    class="form-checkbox" value="dansk">
                <label class="form-label" for="checkboxes-error-option1">Dansk</label>

            </div>

            <div class="form-group-checkbox">
                <input type="checkbox" id="checkboxes-error-option2" name="nationalitet[]"
                    class="form-checkbox" value="svensk">
                <label class="form-label" for="checkboxes-error-option2">Svensk</label>

            </div>

            <div class="form-group-checkbox">
                <input type="checkbox" id="checkboxes-error-option3" name="nationalitet[]"
                    class="form-checkbox" value="anden">
                <label class="form-label" for="checkboxes-error-option3">Anden
                    nationalitet</label>

            </div>

        </fieldset>
    </div>

    <div class="form-group form-error">
        <fieldset aria-describedby="date-input-error-hint date-input-error-error ">
            <legend class="form-label">
                Hvornår blev dit pas udstedt?
            </legend>
            <span class="form-hint" id="date-input-error-hint">For eksempel: 05 12 2018</span>
            <span class="form-error-message" id="date-input-error-error">
                <span class="sr-only">Fejl: </span>Datoen kan ikke være i fremtiden
            </span>
            <div class="date-group mt-3">

                <div class="form-group form-group-day">
                    <label class="form-label" for="date-input-error-day">Dag</label>

                    <input type="number" id="date-input-error-day" name="date-day"
                        class="form-input" value="01" required>
                </div>

                <div class="form-group form-group-month">
                    <label class="form-label" for="date-input-error-month">Måned</label>

                    <input type="number" id="date-input-error-month" name="date-month"
                        class="form-input" value="12" required>
                </div>

                <div class="form-group form-group-year">
                    <label class="form-label" for="date-input-error-year">År</label>

                    <input type="number" id="date-input-error-year" name="date-year"
                        class="form-input" value="2076" required>
                </div>

            </div>
        </fieldset>
    </div>

</form>

Gå til eksemplets retningslinjer

Javascript

Fejlopsummering kræver JavaScript samt attributten data-module="error-summary" for at fungere korrekt. Dermed vil et klik på et link i opsummeringen betyde, at brugeren scroller ned til feltet med fejl uden at scrolle forbi feltets label. Man kan enten gøre brug af DKFDS.init() eller initiere komponenten manuelt med nedenstående:

new DKFDS.ErrorSummary(document.getElementById('ALERT-ID')).init();

Om custom elements

fds-error-summary kan anvendes på to måder:

uden attributten auto, hvor udvikleren selv er ansvarlig for at tilføje fejl til oversigten og styre, hvornår komponenten skal vises
med attributten auto, hvor komponenten automatisk samler alle synlige fejlmeddelelser på siden, som ligger i et understøttet inputelement, og selv viser eller skjuler oversigten afhængigt af, om der er fejl

HTML-muligheder

Som udgangspunkt bør man anvende custom element-koden, da denne kommer med JavaScript, der genererer både den nødvendige HTML og funktionalitet.

Hvis man ikke ønsker at benytte custom elements, kan man tage den genererede HTML i stedet.

Eksempler

Fejlopsummering med custom element

Åbn i et nyt vindue

<fds-error-summary heading-id="error-summary-id"></fds-error-summary>

<fds-error-summary heading-id="error-summary-id">
    <nav aria-labelledby="error-summary-id">
        <svg aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <h2 id="error-summary-id">Der er problemer</h2>
        <ul></ul>
    </nav>
</fds-error-summary>

Varianter

Auto

Med attributten auto opdateres fejloversigten automatisk ud fra synlige fds-error-message i understøttede wrappers. Hvis en fejl er standalone eller befinder sig i en ikke-understøttet parent wrapper, bliver den ikke automatisk føjet til fejloversigten.

Åbn i et nyt vindue

Fornavn

Fornavn ikke indtastet

Efternavn

Efternavn ikke indtastet

<fds-error-summary auto="true" heading-id="error-summary-id1"></fds-error-summary>

<fds-input>
    <label>Fornavn</label>
    <input type="text" id="input-wrapper-error1" name="input-text1" required>
    <fds-error-message id="error77d50f12">Fornavn ikke indtastet</fds-error-message>
</fds-input>

<fds-input>
    <label>Efternavn</label>
    <input type="text" id="input-wrapper-error2" name="input-text2" required>
    <fds-error-message id="error77d50f13">Efternavn ikke indtastet</fds-error-message>
</fds-input>

<fds-error-summary auto="true" heading-id="error-summary-id1">
    <nav aria-labelledby="error-summary-id1">
        <svg aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <h2 id="error-summary-id1">Der er problemer</h2>
        <ul>
            <li data-error-id="error77d50f12">
                <a class="function-link" href="#input-wrapper-error1">Fornavn ikke indtastet</a>
            </li>
            <li data-error-id="error77d50f13">
                <a class="function-link" href="#input-wrapper-error2">Efternavn ikke indtastet</a>
            </li>
        </ul>
    </nav>
</fds-error-summary>
<fds-input>
    <label for="input-wrapper-error1">Fornavn</label>
    <input type="text" id="input-wrapper-error1" name="input-text1" required="" aria-describedby="error77d50f12" aria-invalid="true">
    <fds-error-message id="error77d50f12">
        <svg class="icon-svg alert-icon" aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <span class="visible-message">Fornavn ikke indtastet</span>
    </fds-error-message>
</fds-input>
<fds-input>
    <label for="input-wrapper-error2">Efternavn</label>
    <input type="text" id="input-wrapper-error2" name="input-text2" required="" aria-describedby="error77d50f13" aria-invalid="true">
    <fds-error-message id="error77d50f13">
        <svg class="icon-svg alert-icon" aria-label="Fejl" focusable="false"><use href="#error"></use></svg>
        <span class="visible-message">Efternavn ikke indtastet</span>
    </fds-error-message>
</fds-input>

Understøttede wrappers

fds-error-summary understøtter fejlmeddelelser i følgende wrappers:

fds-input
fds-checkbox
fds-checkbox-group
fds-radio-button-group
fds-date-input
fds-textarea
fds-select
fds-upload-file
fds-date-picker

Fejlmeddelelsen skal være angivet som et fds-error-message inde i wrapperen.

Når der klikkes på et link i fejloversigten, flyttes fokus til det første fokusbare element i den wrapper, som fejlmeddelelsen tilhører, fx et input, select, textarea eller button.

Komponenten viser kun fejl fra wrappers, som ikke er skjulte, og hvor den tilhørende fejlmeddelelse heller ikke er skjult.

Konfiguration

Attributter

Attribut	Beskrivelse
heading	Sæt en anden overskrift end standardoverskriften `"Der er problemer"`.
heading-id	Sætter id på overskriftselementet, så fejlopsummeringen kan referere til overskriften via aria-labelledby.
heading-level	Angiver hvilket overskriftsniveau der anvendes til overskriften. Gyldige værdier er `h1` til `h6`. Standard er `h2`.
auto	Gør komponenten automatisk og holder fejloversigten synkroniseret med `fds-error-message` i understøttede wrappers.

Vælg et tema

Fejlopsummering

Sådan bruges komponenten

Anvendes til

Vejledning

Placering

Sådan (do)

Ikke sådan (don't)

Se komponenten i eksempelløsninger

Referencer

Installation

HTML Struktur

Placering

Javascript

Om custom elements

HTML-muligheder

Eksempler

Fejlopsummering med custom element

Varianter

Auto

Understøttede wrappers

Konfiguration

Attributter