CKTIS / HTML
role — de toegankelijkheidsrol van een element
Het attribuut `role` geeft de semantische rol van een element aan hulptechnologieën door. Het voegt geen uiterlijk of gedrag toe. Gebruik het volgens de regels van ARIA in HTML en geef de voorkeur aan elementen die al de juiste native semantiek bieden.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
role="role-name [fallback-role-name ...]"Het attribuut role geeft hulptechnologieën het type van een element door, zoals een groep of een knop. Het gaat om de semantiek in de toegankelijkheidsboom, niet om het uiterlijk. Het vervangt geen toegankelijke naam: in het voorbeeld geeft group de rol aan en levert aria-label de naam Display options.
De waarde kan door witruimte gescheiden rolnamen bevatten. Om de rol te bepalen gebruikt de browser de eerste herkende naam van een niet-abstracte rol. De lijst bevat terugvalrollen, geen meerdere rollen die tegelijk gelden. De zo gekozen rol is niet noodzakelijk de rol die in de toegankelijkheidsboom wordt weergegeven. Bij een button die focus kan krijgen, moet de browser bijvoorbeeld none of presentation negeren en in plaats daarvan de impliciete knoprol in de toegankelijkheidsboom weergeven. Abstracte rollen mogen niet in pagina-inhoud worden gebruikt.
Geef de voorkeur aan een native HTML-element met de juiste semantiek. button heeft al de knoprol, dus die herhalen is overbodig. Welke overschrijvingen zijn toegestaan, hangt af van het element en de regels van ARIA in HTML; niet elke rol is overal geldig. Voldoe ook aan de eisen van de gekozen rol voor namen, toestanden en structuur.
Alleen role="button" toevoegen zorgt niet voor toetsenbordbediening, focusmogelijkheden of acties. Het voorbeeld groepeert twee native keuzerondjes (<input type="radio">) zonder hun rollen te overschrijven. Als de geselecteerde optie verandert, past het script de lettergrootte van de voorbeeldtekst aan. output bevat de console-uitvoer met de gedeclareerde waarden van role en aria-label en de zichtbare tekst van de groep. De toegankelijkheidsboom wordt daarbij niet geïnspecteerd.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named group of display options</title>
</head>
<body>
<div id="display-options" role="group" aria-label="Display options">
<label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
<label><input type="radio" name="zoom" value="large"> Large size</label>
</div>
<p id="sample">Sample text</p>
<script>
const group = document.getElementById('display-options');
const sample = document.getElementById('sample');
group.addEventListener('change', event => {
sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
});
console.log('Declared role: ' + group.getAttribute('role'));
console.log('ARIA label: ' + group.getAttribute('aria-label'));
console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
</script>
</body>
</html>Resultaat
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.