Naar de inhoud

Ordered List

Lijst waarvan de volgorde van items betekenis heeft.

Checklist voor toegankelijkheid

Hier beschrijven we waar de component al aan voldoet en wat je zelf nog moet doen om de component toegankelijk én gebruiksvriendelijk in te zetten.

Acceptatiecriteria bij gebruik

Een component gebruik je in de context van een pagina, website of applicatie. Hoe toegankelijk en gebruiksvriendelijk een component is, hangt daarom voor een groot deel af van context. We hebben onderstaande criteria verdeeld op rol: de developer, de designer en de contentmaker. Vanuit iedere rol kun je je steentje bijdragen om een toegankelijke en gebruiksvriendelijke ervaring te bieden aan je gebruikers.

Filter acceptatiecriteria voor:

1 van de 1 items zijn nu zichtbaar.

  • De Ordered List bestaat uit een list met list-items.

    Het parent HTML element van de Unordered en Ordered List mag alleen list-items bevatten:

    <ul>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
    </ul>
    

    Dit geldt ook voor geneste Unordered en Ordered Lists:

    <ul>
      <li>List-item voorbeeld</li>
      <li>
        List-item voorbeeld
        <ul>
          <li>Genest list-item voorbeeld</li>
          <li>Genest list-item voorbeeld</li>
        </ul>
      </li>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
    </ul>
    

    NL Design System richtlijnen:

    developerWCAG 1.3.1Niveau A
  • De tekst en de tekstuele markers in de Ordered List hebben een contrastratio van minimaal 4,5:1 met de achtergrondkleur.

    De contrastverhouding van de tekstkleur met de achtergrondkleur is hoog genoeg. Minimale contrastverhoudingen:

    • 4,5:1 contrast voor normale tekst.
    • 3:1 contrast voor grotere letters (vanaf 24 pixels).
    • 3:1 contrast voor vette letters (vet en groter of gelijk aan 19 pixels).

    Hogere verhoudingen mogen natuurlijk altijd. Met de Contrast checker kun je controleren of je gekozen kleuren voldoen. Denk erom dat dit moet gelden voor alle achtergrondkleuren waarop de tekst geplaatst kan worden. Het kan dus zijn dat je meerdere checks moet doen.

    NL Design System richtlijnen:

    designerWCAG 1.4.3Niveau AA
  • Als de bezoeker de Ordered List tot 400% vergroot, blijft alle tekst zichtbaar en leesbaar.

    Er mag geen inhoud buiten beeld vallen, onbereikbaar of verborgen zijn of gedeeltelijk verborgen worden door andere inhoud wanneer de gebruiker 400% inzoomt of op een buitengewoon klein scherm werkt (320 bij 256 pixels).

    Definieer in de CSS een wijze om lange woorden af te breken en te laten doorlopen op de volgende regel. Gebruik hiervoor bijvoorbeeld overflow-wrap: break-word; hyphens: auto; eventueel in combinatie met text-wrap-style: balance. Zo ontstaat er geen horizontale scrollbar en wordt tekst niet onleesbaar. Doe dit bij voorkeur op :root niveau.

    Bij de Ordered List kan er informatie verloren gaan als het startgetal (de marker) veel ruimte inneemt. Bijvoorbeeld:

    <ol start="10000090">
      <li>Hallo</li>
      <li>Ik</li>
      <li>Ben</li>
      <li>Een</li>
      <li>Lijst</li>
    </ol>
    

    Een deel van het getal is dan niet meer zichtbaar. Je kunt dit oplossen door in CSS een grotere margin-inline-start te gebruiken voor Ordered Lists met brede markers.

    developerdesignerWCAG 1.4.10Niveau AA
  • De Ordered List is niet bereikbaar en bedienbaar met het toetsenbord.

    Componenten en elementen die niet interactief zijn, zijn niet bereikbaar en bedienbaar met het toetsenbord.

    Een uitzondering geldt voor situaties waarbij een interactief element zoals een Skip Link of een Link in een Side Navigation, de bezoeker direct naar de component of het element stuurt.

    NL Design System richtlijnen:

    developerWCAG 2.1.1Niveau A
  • De Ordered List komt niet voor in de normale focusvolgorde van de pagina.

    Componenten en elementen die niet interactief zijn, komen niet voor in de normale toetsenbord-focusvolgorde van de pagina.

    Een uitzondering geldt voor situaties waarbij een interactief component een Skip Link of een Link in een Side Navigation, de bezoeker direct naar de component of het element stuurt.

    NL Design System richtlijnen:

    developerWCAG 2.4.3Niveau A
  • Als de tekst in de Ordered List in een andere is dan de taal van de pagina, is dat duidelijk aangegeven.

    Als een tekst in een andere taal is dan de taal van de pagina, dan heeft het element een lang-attribuut met de juiste taalcode.

    Dit doe je op het parent-element wanneer de hele inhoud in een andere taal is geschreven, of op het child-element waarvan de inhoud in een andere taal is geschreven.

    Als de hele Ordered List in een andere taal is geschreven:

    <ol lang="en">
      <li>First item</li>
      <li>Second item</li>
      <li>Third item</li>
    </ol>
    

    Als alleen de inhoud van één van de items in een andere taal is geschreven:

    <ol>
      <li>Eerste item</li>
      <li lang="en">Second item</li>
      <li>Derde item</li>
    </ol>
    

    Of:

    <ol>
      <li>Eerste item</li>
      <li><p lang="en">Second item</p></li>
      <li>Derde item</li>
    </ol>
    

    NL Design System richtlijnen:

    developerWCAG 3.1.2Niveau AA

Acceptatiecriteria van de component

Als je de NL Design System component gebruikt kun je er vanuit gaan dat onderstaande checks zijn gedaan. Maar door keuzes in de website of applicaties kan het natuurlijk zijn dat ze toch niet helemaal werken. Voor de zekerheid is het dus goed om ook op onderstaande punten te letten.

Filter acceptatiecriteria voor:

1 van de 1 items zijn nu zichtbaar.

  • De Ordered List is herkenbaar als geordende lijst voor hulpsoftware.

    De Ordered List is herkenbaar voor hulpsoftware als geordende lijst omdat de component is opgemaakt met ol en li elementen. In de browser Safari (NL Design System baseline mei 2026) verdwijnt de semantiek van de lijst zodra in CSS list-style: none wordt gebruikt. Daarom is de ARIA rol list toegevoegd.

    <ol role="list">
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
      <li>List-item voorbeeld</li>
    </ol>
    

    NL Design System richtlijnen:

    developerWCAG 1.3.1Niveau A
  • Als je de tekst van de Ordered List vergroot tot 200% blijft deze in zijn geheel zichtbaar.

    Als je de tekst vergroot tot 200%, via browserzoom of via de browserinstellingen voor tekstgrootte, blijft de tekst volledig zichtbaar.

    Zorg ervoor dat de component meegroeit met de tekst. Definieer hoogte en de breedte niet in px, maar gebruik een relatieve waarde als em of rem.

    Definieer in de CSS een wijze om lange woorden af te breken en te laten doorlopen op de volgende regel. Gebruik hiervoor bijvoorbeeld overflow-wrap: break-word; hyphens: auto; eventueel in combinatie met text-wrap-style: balance. Zo ontstaat er geen horizontale scrollbar en wordt tekst niet onleesbaar. Doe dit bij voorkeur op :root niveau.

    NL Design System richtlijnen:

    developerWCAG 1.4.4Niveau AA
  • Tekst in de Ordered List blijft leesbaar wanneer de tekstafstand vergroot wordt.

    Als je de tekstafstand vergroot blijft de tekst in zijn geheel zichtbaar. Dit gaat om regelhoogte, afstand tussen alinea’s, letterafstand en ruimte tussen woorden. Gebruikers kunnen dit instellen vanuit hun browser. Het is niet nodig om hier buttons voor te maken in de website zelf.

    Zorg ervoor dat de component mee kan groeien met de tekst. Geef de breedte en de hoogte dus niet hard op in pixels.

    Definieer in de CSS een wijze om lange woorden af te breken en te laten doorlopen op de volgende regel. Gebruik hiervoor bijvoorbeeld overflow-wrap: break-word; hyphens: auto; eventueel in combinatie met text-wrap-style: balance. Zo ontstaat er geen horizontale scrollbar en wordt tekst niet onleesbaar. Doe dit bij voorkeur op :root niveau.

    Je moet de afstand kunnen vergroten naar deze waardes:

    • Regelhoogte (regelafstand) naar ten minste 1,5 keer de lettergrootte.
    • Afstand tussen alinea’s naar ten minste 2 keer de lettergrootte.
    • Letterafstand (spatiëren van letters) naar ten minste 0,12 keer de lettergrootte.
    • Spatiëren van woorden naar ten minste 0,16 keer de lettergrootte.

    Dit is te testen met een extensie zoals Stylus of User CSS, een bookmarklet of door in de inspector van de browser de volgende code toe te voegen aan de head van de pagina:

    <style>
    body * {
        line-height: 1.5 !important;
        letter-spacing: 0.12em !important;
        word-spacing: 0.16em !important;
    }
    body p {
        margin-bottom: 2em !important;
    }
    </style>
    

    NL Design System richtlijnen:

    developerWCAG 1.4.12Niveau AA
  • De Ordered List is standaard niet bereikbaar en bedienbaar met het toetsenbord.

    Niet-interactieve componenten en elementen zijn standaard niet bereikbaar en bedienbaar met het toetsenbord.

    NL Design System richtlijnen:

    developerWCAG 2.1.1Niveau A
  • De Ordered List komt standaard niet voor in de focusvolgorde van de pagina.

    Niet-interactieve componenten en elementen komen standaard niet voor in de toetsenbord-focusvolgorde van de pagina.

    NL Design System richtlijnen:

    developerWCAG 2.4.3Niveau A

Definition of Done

Community implementaties

Gerelateerde componenten: Rich Text Content, Unordered List.

Help om deze component te verbeteren

We vinden het belangrijk dat de component Ordered List goed te gebruiken is door iedereen. Help je mee?