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.
NootDit 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 werkaria-valuenowbij tijdens het schuiven. Ligt het bereik niet tussen 0 en 100? Voeg dan ookaria-valueminenaria-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
- 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
- Bepaal welke bedieningselementen er zijn:
- Zoek in de code naar links (
<a>– en<area>-elementen met eenhref-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)
- Of de toestand uitgeklapt of ingeklapt in de code staat (bijvoorbeeld met een
- Zoek in de code naar knoppen (
<button>-element,<input>-element met het typebutton,submit,resetofimage, 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)
- Of de toestand uitgeklapt of ingeklapt in de code staat (bijvoorbeeld met een
- Zoek in de code naar formulierelementen (
<input>,<select>,<textarea>) en controleer:- Of het element een toegankelijke naam heeft (zie De toegankelijke naam bepalen)
- 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
- 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-expandedofaria-pressed) - Of de toegankelijke naam wordt bijgewerkt als de functie verandert (bijvoorbeeld van “Afspelen” naar “Pauzeren”)
- Of de toestand in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld
- 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.
- Schakel een schermlezer in
- 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
- 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
- Herhaal stap 8 tot en met 10 met een andere schermlezer
Test 2: Maatwerk bedieningselementen
- Verken de pagina
- Bepaal welke maatwerk bedieningselementen er zijn:
- Knoppen en links die niet met
<button>of<a>methref-attribuut zijn gebouwd (bijvoorbeeld een<div>,<span>of<a>zonderhrefmet 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
- Knoppen en links die niet met
- Bepaal welke maatwerk bedieningselementen er zijn:
- 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)
- 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,sliderofswitch) - 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
- Of de rol past bij de functie van het element (bijvoorbeeld
- 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-checkedofaria-pressed) - Of de waarde in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld
aria-valuenowofaria-valuetext) - Of de eigenschappen die de gebruiker verandert worden bijgewerkt (bijvoorbeeld
aria-sortna 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-activedescendantoftabindex)
- Of de toestand in de accessibility tree wordt bijgewerkt na de wijziging (bijvoorbeeld
- 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.
- Schakel een schermlezer in
- 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
- Test de maatwerk bedieningselementen met de schermlezer en controleer:
- Of de schermlezer de nieuwe toestand, waarde of toegankelijke naam aankondigt na de wijziging
- Herhaal stap 6 tot en met 8 met een andere schermlezer
Test 3: Iframes
- Zoek in de code naar
<iframe>-elementen die niet verborgen zijn voor hulptechnologie en met Tab te bereiken zijn en controleer:- Of het element een toegankelijke naam heeft (zie De toegankelijke naam bepalen)
Test 4: ARIA-attributen
- 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 zoalswidgetofinputtellen niet mee)
- Of het
- 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
trueoffalsebijaria-expanded, een getal bijaria-valuenow)
- 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-labelofaria-describedby) - Of het attribuut hoort bij de rol van het element (bijvoorbeeld
aria-pressedbijbutton) - Of het attribuut volgens ARIA in HTML is toegestaan op dat HTML-element
- Of het attribuut globaal is (bijvoorbeeld
- 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-checkedbijcheckboxenswitch,aria-expandedbijcombobox) - Of die vereiste attributen een waarde hebben die niet leeg is
- Of het element alle attributen heeft die de rol vereist en waarvoor WAI-ARIA geen standaardwaarde geeft (bijvoorbeeld
- Zoek in de code naar id-verwijzingen die de naam of de focus bepalen en controleer:
- Of elke verwijzing in een
for-,aria-labelledby– ofaria-activedescendant-attribuut naar een bestaand element verwijst - Of de id-waarde waarnaar wordt verwezen uniek is
- Of elke verwijzing in een
- 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
- Zoek in de code naar elementen met de rol
button,checkbox,img,menuitemcheckbox,menuitemradio,meter,option,progressbar,radio,scrollbar,separator,slider,switchoftab(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
- 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– ofaria-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-labelledbyenaria-activedescendantmoeten 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,switchoftabmag geen elementen bevatten die met Tab te bereiken zijn - Een link mag geen andere link of knop bevatten
Bronnen
- WCAG 2.2 – Succescriterium 4.1.2 Naam, rol, waarde
- WAI-ARIA 1.3 (Engelstalig)
- Accessible Name and Description Computation 1.2 (Engelstalig)