4.1.2 Naam, rol, waarde

Succescriterium 4.1.2 Naam, rol, waarde

Voor alle componenten van de gebruikersinterface (inclusief, maar niet uitsluitend voor formulierelementen, links en door scripts gegenereerde componenten), kunnen de naam (name) en rol (role) door software bepaald worden; toestanden (states), eigenschappen (properties) en waarden (values) die door de gebruiker ingesteld kunnen worden, kunnen door software ingesteld worden; en kennisgeving van veranderingen in deze items is beschikbaar voor user agents, met inbegrip van hulptechnologieën.

Noot

Dit succescriterium is primair voor webauteurs die hun eigen componenten van de gebruikersinterface ontwikkelen of scripten. Standaard bedieningselementen in HTML bijvoorbeeld voldoen al aan dit succescriterium als ze gebruikt worden volgens specificatie.

Naam, rol, waarde begrijpen (Engelstalig)

Bedieningselementen, zoals links, knoppen en formulierelementen, hebben vijf kenmerken die hulptechnologie moet kunnen uitlezen: naam, rol, toestand, eigenschappen en waarde. De naam identificeert het element, bijvoorbeeld “Zoeken”. De rol vertelt wat voor soort element het is, bijvoorbeeld een knop. De toestand vertelt in welke stand het element staat, bijvoorbeeld uitgeklapt of ingeklapt. De eigenschappen geven aanvullende kenmerken, zoals de richting waarin een tabelkolom is gesorteerd. De waarde vertelt wat er is ingevuld of gekozen.

Hulptechnologie moet de toestand, eigenschappen en waarde ook zelf kunnen veranderen. Spraakbesturing moet bijvoorbeeld een selectievakje kunnen aanvinken.

Bij standaard HTML-elementen regelt de browser de rol, de waarde en de vaste toestanden automatisch, zoals aangevinkt bij een selectievakje. De naam moet je zelf verzorgen, bijvoorbeeld met een <label> bij een invoerveld of met linktekst bij een link. Geef je een standaard element extra gedrag, zoals een knop die een menu uitklapt? Dan voeg je die toestand zelf toe.

Bouw je een maatwerk bedieningselement, zoals een eigen accordeon of schuifregelaar? Dan moet je deze informatie zelf toevoegen. Elke wijziging moet ook automatisch naar hulptechnologie gaan. Een schermlezer weet dan altijd of een accordeon open of dicht is, zonder dat de gebruiker opnieuw naar het element hoeft te gaan.

Hoe pas je dit toe?

  • Geef elk bedieningselement een naam en een rol die software kan bepalen.
  • Zorg dat hulptechnologie de toestand, eigenschappen en waarde kan uitlezen en instellen, als de gebruiker die kan veranderen.
  • Geef elke wijziging in toestand, eigenschap of waarde automatisch door aan hulptechnologie.
  • Verandert de functie van een bedieningselement? Werk dan ook de naam bij. Wordt een knop “Afspelen” een knop “Pauzeren”, dan moet de naam meeveranderen.
  • Bouw je een samengesteld bedieningselement, zoals een maatwerk keuzelijst of boomstructuur? Zorg dan dat hulptechnologie weet welk onderdeel de focus heeft.
Wanneer zijn toestand en eigenschap verplicht?

Naam en rol moeten altijd door software bepaald kunnen worden. Bij toestanden, eigenschappen en waarden staat een voorwaarde in het succescriterium. Alleen die “door de gebruiker ingesteld kunnen worden” tellen mee.

De vraag is dus: kan de gebruiker dit zelf veranderen?

  • Ja: de gebruiker vinkt aan, vouwt uit, drukt in of versleept een regelaar. Deze moeten in de code aanwezig zijn.
  • Nee: de site zet de toestand, zoals bij een uitgeschakelde knop of de markering van de huidige pagina. Die vallen buiten dit succescriterium.

Lees het artikel over naam, rol, waarde

Handige tips

  • Gebruik native HTML-elementen waar het kan, zoals <button>, <input>, <select>, <details> en <summary> voor een accordeon en <dialog> voor een dialoogvenster.
  • Gebruik aria-expanded="true" of "false" bij uit- en inklapbare elementen, zoals een accordeon of menu. Werk de waarde bij zodra de toestand verandert.
  • Gebruik aria-checked="true" of "false" bij maatwerk selectievakjes en keuzerondjes en schuifschakelaars.
  • Gebruik aria-selected="true" of "false" bij tabbladen en bij opties in een keuzelijst.
  • Gebruik aria-pressed="true" of "false" bij een schakelknop. (Laat de naam van de knop dan gelijk, want de toestand vertelt al of hij aan of uit staat.)
  • Gebruik aria-valuenowbij een maatwerk schuifregelaar, en werk aria-valuenow bij tijdens het schuiven. Ligt het bereik niet tussen 0 en 100? Voeg dan ook aria-valuemin en aria-valuemaxtoe.
  • Gebruik ARIA-attributen voor maatwerk componenten (bekijk ook mijn componenten).

Voor wie is dit belangrijk?

  • Mensen die een schermlezer gebruiken.
  • Mensen die blind of slechtziend zijn.
  • Mensen die een cognitieve, taal- of leerbeperking hebben.

Wie is verantwoordelijk?

Hoe toets je dit?

Benodigdheden
  • Minimaal twee verschillende schermlezers (bijvoorbeeld NVDA en VoiceOver)
Testprocedure

Test 1: Standaard bedieningselementen

  1. Verken de pagina
    • Bepaal welke bedieningselementen er zijn:
      • Links
      • Knoppen
      • Formulierelementen (invoervelden, tekstgebieden, keuzelijsten, selectievakjes, keuzerondjes, schuifregelaars)
    • Bepaal welke bedieningselementen van toestand of functie veranderen
  2. Zoek in de code naar links (<a>– en <area>-elementen met een href-attribuut) en controleer:
    • Of het element een toegankelijke naam heeft (zie De toegankelijke naam bepalen)
    • Bij een link die een onderdeel in- en uitklapt:
      • Of de toestand uitgeklapt of ingeklapt in de code staat (bijvoorbeeld met een aria-expanded-attribuut)
  3. Zoek in de code naar knoppen (<button>-element, <input>-element met het type button, submit, reset of image, en <summary>-element in een <details>-element) en controleer:
    • Of het element een toegankelijke naam heeft (zie De toegankelijke naam bepalen)
    • Bij een knop die een onderdeel in- en uitklapt:
      • Of de toestand uitgeklapt of ingeklapt in de code staat (bijvoorbeeld met een aria-expanded-attribuut)
  4. Zoek in de code naar formulierelementen (<input>, <select>, <textarea>) en controleer:
  5. Zoek in de code naar de bedieningselementen en controleer voor elk element in de accessibility tree:
    • Of de rol past bij de functie van het element
    • Of de toestand overeenkomt met de zichtbare toestand en past bij het gedrag van het element:
      • Selectievakje: aangevinkt of niet aangevinkt
      • Keuzerondje: geselecteerd of niet geselecteerd
      • Keuzelijst: uitgeklapt of ingeklapt
      • Schakelknop: ingedrukt of niet ingedrukt
      • Uitklapmenu: uitgeklapt of ingeklapt
    • Of de waarde overeenkomt met de zichtbare waarde
  6. Zoek in de code naar de bedieningselementen die van toestand of functie veranderen en controleer na het bedienen van elk element:
    • Of de toestand in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld aria-expanded of aria-pressed)
    • Of de toegankelijke naam wordt bijgewerkt als de functie verandert (bijvoorbeeld van “Afspelen” naar “Pauzeren”)
  7. Zoek in de code naar schakelknoppen (knoppen die aan en uit kunnen staan) zonder toestand in de accessibility tree en controleer:
    • Of de toegankelijke naam meeverandert met de toestand (bijvoorbeeld van “Geluid aan” naar “Geluid uit”)

Let op: Alleen als de accessibility tree geen duidelijk beeld geeft.

  1. Schakel een schermlezer in
  2. Navigeer met de schermlezer naar elk bedieningselement, vergelijk de aankondiging met de accessibility tree en controleer:
    • Of de schermlezer dezelfde toegankelijke naam aankondigt
    • Of de schermlezer een rol aankondigt die past bij de rol in de accessibility tree
    • Of de schermlezer dezelfde toestand of waarde aankondigt
  3. Test de bedieningselementen die van toestand of functie veranderen met de schermlezer en controleer:
    • Of de schermlezer de nieuwe toestand, waarde of toegankelijke naam aankondigt na de wijziging
  4. Herhaal stap 8 tot en met 10 met een andere schermlezer

Test 2: Maatwerk bedieningselementen

  1. Verken de pagina
    • Bepaal welke maatwerk bedieningselementen er zijn:
      • Knoppen en links die niet met <button> of <a> met href-attribuut zijn gebouwd (bijvoorbeeld een <div>, <span> of <a> zonder href met een klikfunctie)
      • Maatwerk formulierelementen (selectievakjes, keuzerondjes, keuzelijsten)
      • Accordeons of andere elementen die kunnen uitvouwen en samenvouwen
      • Carrousels
      • Comboboxen
      • Dialoogvensters
      • Uitklapmenu’s
      • Schakelknoppen
      • Schuifregelaars
      • Schuifschakelaars
      • Tabbladen
      • Mediaspelers
      • Andere maatwerk bedieningselementen
  2. Zoek in de code naar maatwerk bedieningselementen en controleer:
    • Of het element een toegankelijke naam heeft (zie De toegankelijke naam bepalen)
    • Of de eigenschappen die de gebruiker verandert in de code staan (bijvoorbeeld aria-sort)
  3. Zoek in de code naar de maatwerk bedieningselementen en controleer voor elk element in de accessibility tree:
    • Of de rol past bij de functie van het element (bijvoorbeeld button, checkbox, tab, dialog, combobox, slider of switch)
    • Of de toestand in de accessibility tree staat en past bij het gedrag van het element:
      • Accordeon: uitgeklapt of ingeklapt
      • Combobox: uitgeklapt of ingeklapt
      • Maatwerk selectievakje: aangevinkt of niet aangevinkt
      • Maatwerk keuzerondje: geselecteerd of niet geselecteerd
      • Optie in een keuzelijst: geselecteerd of niet geselecteerd
      • Tabblad: geselecteerd of niet geselecteerd
      • Schuifschakelaar: aan of uit
      • Schakelknop: ingedrukt of niet ingedrukt
      • Uitklapmenu: uitgeklapt of ingeklapt
    • Of de waarde overeenkomt met de zichtbare waarde:
      • Combobox: de gekozen optie
      • Schuifregelaar: de huidige waarde
  4. Zoek in de code naar de maatwerk bedieningselementen en controleer na het bedienen van elk element:
    • Of de toestand in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld aria-expanded, aria-selected, aria-checked of aria-pressed)
    • Of de waarde in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld aria-valuenow of aria-valuetext)
    • Of de eigenschappen die de gebruiker verandert worden bijgewerkt (bijvoorbeeld aria-sort na het sorteren)
    • Of de toegankelijke naam wordt bijgewerkt als de functie verandert
    • Of de focus in de code ligt op het onderdeel dat visueel de focus heeft (bijvoorbeeld via aria-activedescendant of tabindex)
  5. Zoek in de code naar maatwerk schakelknoppen zonder toestand in de accessibility tree en controleer:
    • Of de toegankelijke naam meeverandert met de toestand (bijvoorbeeld van “Geluid aan” naar “Geluid uit”)

Let op: Alleen als de accessibility tree geen duidelijk beeld geeft.

  1. Schakel een schermlezer in
  2. Navigeer met de schermlezer naar elk maatwerk bedieningselement, vergelijk de aankondiging met de accessibility tree en controleer:
    • Of de schermlezer dezelfde toegankelijke naam aankondigt
    • Of de schermlezer een rol aankondigt die past bij de rol in de accessibility tree
    • Of de schermlezer dezelfde toestand of waarde aankondigt
    • Of de schermlezer het onderdeel aankondigt dat visueel de focus heeft
  3. Test de maatwerk bedieningselementen met de schermlezer en controleer:
    • Of de schermlezer de nieuwe toestand, waarde of toegankelijke naam aankondigt na de wijziging
  4. Herhaal stap 6 tot en met 8 met een andere schermlezer

Test 3: Iframes

  1. Zoek in de code naar <iframe>-elementen die niet verborgen zijn voor hulptechnologie en met Tab te bereiken zijn en controleer:

Test 4: ARIA-attributen

  1. Zoek in de code naar bedieningselementen met een role-attribuut dat een waarde heeft en controleer:
    • Of het role-attribuut minstens één geldige rol uit WAI-ARIA bevat (abstracte rollen zoals widget of input tellen niet mee)
  2. Zoek in de code naar aria--attributen op bedieningselementen en controleer:
    • Of elk attribuut bestaat in WAI-ARIA
    • Of elk attribuut met een waarde een geldige waarde heeft voor het type van het attribuut (bijvoorbeeld true of false bij aria-expanded, een getal bij aria-valuenow)
  3. Zoek in de code naar aria--attributen op bedieningselementen en controleer voor elk attribuut of minstens één van de volgende waar is:
    • Of het attribuut globaal is (bijvoorbeeld aria-label of aria-describedby)
    • Of het attribuut hoort bij de rol van het element (bijvoorbeeld aria-pressed bij button)
    • Of het attribuut volgens ARIA in HTML is toegestaan op dat HTML-element
  4. Zoek in de code naar bedieningselementen met een expliciete rol die afwijkt van de impliciete rol van het HTML-element en controleer:
    • Of het element alle attributen heeft die de rol vereist en waarvoor WAI-ARIA geen standaardwaarde geeft (bijvoorbeeld aria-checked bij checkbox en switch, aria-expanded bij combobox)
    • Of die vereiste attributen een waarde hebben die niet leeg is
  5. Zoek in de code naar id-verwijzingen die de naam of de focus bepalen en controleer:
    • Of elke verwijzing in een for-, aria-labelledby– of aria-activedescendant-attribuut naar een bestaand element verwijst
    • Of de id-waarde waarnaar wordt verwezen uniek is
  6. Zoek in de code naar elementen met aria-hidden="true" en controleer:
    • Of het element zelf niet met Tab te bereiken is
    • Of het element geen elementen bevat die met Tab te bereiken zijn

Test 5: Geneste bedieningselementen

  1. Zoek in de code naar elementen met de rol button, checkbox, img, menuitemcheckbox, menuitemradio, meter, option, progressbar, radio, scrollbar, separator, slider, switch of tab (ook als de rol van het HTML-element zelf komt, zoals bij <button>) en controleer:
    • Of het element geen elementen bevat die met Tab te bereiken zijn
  2. Zoek in de code naar links (ook elementen met de rol link) en controleer:
    • Of de link geen andere link of knop bevat

Belangrijk om te weten

  • De code en de accessibility tree zijn leidend voor de beoordeling. De schermlezers dienen ter verificatie.
  • Kondigt een schermlezer iets anders aan dan de accessibility tree laat zien, dan wordt de code opnieuw gecontroleerd. Een afwijkende aankondiging is op zichzelf geen bevinding.
  • De ARIA Authoring Practices Guide en de componenten in de kennisbank zijn handig om een maatwerk bedieningselement mee te vergelijken. Exacte naleving is niet verplicht, zolang naam, rol, toestand, eigenschap en waarde toegankelijk zijn.
  • Een link die een functie van een knop uitvoert, of een knop die naar een andere pagina leidt, zakt niet op een passende rol. WCAG noemt dit niet als fout. De rol past niet als het element geen rol heeft, of een rol die niets met de functie te maken heeft.
  • De eisen aan ARIA-rollen en ARIA-attributen volgen de ACT-regels “Role attribute has valid value” (674b10), “ARIA attribute is defined in WAI-ARIA” (5f99a7), “ARIA state or property has valid value” (6a7281) en “Element with role attribute has required states and properties” (4e8ab6). Een browser negeert een ongeldige rol of een ongeldig attribuut, en of naam, rol en toestand daarna nog kloppen, hangt af van toevallige terugvalwaarden.
  • De ARIA-eisen gelden in deze beoordeling alleen voor bedieningselementen. De ACT-regels “Role attribute has valid value” (674b10), “ARIA attribute is defined in WAI-ARIA” (5f99a7), “ARIA state or property has valid value” (6a7281) en “Element with role attribute has required states and properties” (4e8ab6) gelden voor alle elementen. Dit succescriterium gaat over bedieningselementen, dus een ARIA-fout op een ander element valt hier buiten.
  • De eis dat een ARIA-attribuut is toegestaan op het element, staat niet letterlijk in WCAG. De eis volgt WAI-ARIA en ARIA in HTML. Browsers verwerken een niet-toegestaan attribuut niet op dezelfde manier, waardoor niet zeker is dat de toestand of eigenschap bij hulptechnologie aankomt.
  • De eis dat id-verwijzingen in een for-, aria-labelledby– of aria-activedescendant-attribuut naar een bestaand element met een uniek id verwijzen, staat niet letterlijk in WCAG. De eis volgt de HTML-specificatie en WAI-ARIA. Gaat een verwijzing nergens heen of naar een dubbel id, dan hangen de naam en de focus af van toevallige terugvalwaarden.
  • De eis dat een link geen andere link of knop bevat, staat niet letterlijk in WCAG. De eis volgt de HTML-specificatie, die interactieve inhoud in een link niet toestaat. Browsers verwerken geneste links en knoppen niet op dezelfde manier, waardoor niet zeker is dat naam en rol van beide elementen bij hulptechnologie aankomen.
Beoordeling

Links

  • Links moeten een toegankelijke naam hebben
  • Links moeten een passende rol hebben
  • Bij een link die een onderdeel in- en uitklapt moet de toestand in de code staan
  • Bij een link die een onderdeel in- en uitklapt moet de toestand worden bijgewerkt bij een wijziging

Knoppen

  • Knoppen moeten een toegankelijke naam hebben
  • Knoppen moeten een passende rol hebben
  • Bij een knop die een onderdeel in- en uitklapt moet de toestand in de code staan
  • Bij een knop die een onderdeel in- en uitklapt moet de toestand worden bijgewerkt bij een wijziging
  • Voor alle schakelknoppen (knoppen die aan en uit kunnen staan) moet minstens één van de volgende zaken gelden:
    • De toestand staat in de code en wordt bijgewerkt bij een wijziging
    • De toegankelijke naam verandert mee met de toestand

Formulierelementen

  • Formulierelementen moeten een toegankelijke naam hebben
  • Formulierelementen moeten een passende rol hebben
  • De toestand van een formulierelement moet in de code overeenkomen met de zichtbare toestand
  • De waarde van een formulierelement moet in de code overeenkomen met de zichtbare waarde

Maatwerk bedieningselementen

  • Maatwerk bedieningselementen moeten een toegankelijke naam hebben
  • Maatwerk bedieningselementen moeten een passende rol hebben
  • Voor alle toestanden die de gebruiker verandert bij een maatwerk bedieningselement moet minstens één van de volgende zaken gelden:
    • De toestand staat in de code en wordt bijgewerkt bij een wijziging
    • Alleen bij schakelknoppen: de toegankelijke naam verandert mee met de toestand
  • Bij een maatwerk bedieningselement moet een eigenschap die de gebruiker verandert in de code staan
  • Bij een maatwerk bedieningselement moet een eigenschap die de gebruiker verandert worden bijgewerkt bij een wijziging
  • Bij een maatwerk bedieningselement moet een waarde die de gebruiker verandert in de code staan
  • Bij een maatwerk bedieningselement moet een waarde die de gebruiker verandert worden bijgewerkt bij een wijziging
  • Bij een maatwerk bedieningselement moet de focus in de code liggen op het onderdeel dat visueel de focus heeft

Toestanden en eigenschappen

  • Een toestand van een bedieningselement moet passen bij het gedrag van het element
  • De toegankelijke naam van een bedieningselement moet worden bijgewerkt als de functie verandert

ARIA

  • Het role-attribuut van een bedieningselement moet minstens één geldige, niet-abstracte rol uit WAI-ARIA bevatten
  • ARIA-attributen op een bedieningselement moeten bestaan in WAI-ARIA
  • ARIA-attributen met een waarde op een bedieningselement moeten een geldige waarde hebben voor het type van het attribuut
  • Voor alle ARIA-attributen op een bedieningselement moet minstens één van de volgende zaken gelden:
    • Het attribuut is globaal
    • Het attribuut hoort bij de rol van het element
    • Het attribuut is volgens ARIA in HTML toegestaan op het HTML-element
  • Bij een bedieningselement met een expliciete rol die afwijkt van de impliciete rol moet het element alle ARIA-attributen hebben die de rol vereist en waarvoor WAI-ARIA geen standaardwaarde geeft, met een waarde die niet leeg is
  • Id-verwijzingen in for, aria-labelledby en aria-activedescendant moeten naar een bestaand element verwijzen
  • Id-waarden waarnaar deze attributen verwijzen moeten uniek zijn
  • Elementen met aria-hidden="true" mogen niet met Tab te bereiken zijn en mogen geen elementen bevatten die met Tab te bereiken zijn

Overig

  • <iframe>-elementen die niet verborgen zijn voor hulptechnologie en met Tab te bereiken zijn, moeten een toegankelijke naam hebben
  • Een element met de rol button, checkbox, img, menuitemcheckbox, menuitemradio, meter, option, progressbar, radio, scrollbar, separator, slider, switch of tab mag geen elementen bevatten die met Tab te bereiken zijn
  • Een link mag geen andere link of knop bevatten

Bronnen

Andere richtlijnen

Lees verder

Laatst gewijzigd op