CKTIS / HTML
role — die Barrierefreiheitsrolle eines Elements
Das Attribut `role` gibt die semantische Rolle eines Elements für assistive Technologien an. Es fügt weder Aussehen noch Verhalten hinzu. Verwende es gemäß den Regeln von ARIA in HTML und bevorzuge Elemente, die bereits passende native Semantik bieten.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
role="role-name [fallback-role-name ...]"Das Attribut role vermittelt assistiven Technologien den Typ eines Elements, etwa eine Gruppe oder eine Schaltfläche. Es betrifft die Semantik im Barrierefreiheitsbaum, nicht das Aussehen. Es ersetzt keinen zugänglichen Namen: Im Beispiel legt group die Rolle fest und aria-label den Namen Display options.
Der Wert kann durch Leerraumzeichen getrennte Rollennamen enthalten. Zur Rollenbestimmung verwendet der Browser den ersten erkannten Namen einer nicht abstrakten Rolle. Die Liste bietet Ersatzrollen, nicht mehrere gleichzeitig geltende Rollen. Die so ausgewählte Rolle entspricht jedoch nicht unbedingt der Rolle im Barrierefreiheitsbaum. Bei einem fokussierbaren button muss der Browser beispielsweise none oder presentation ignorieren und stattdessen die implizite Schaltflächenrolle im Barrierefreiheitsbaum bereitstellen. Abstrakte Rollen dürfen nicht in Seiteninhalten verwendet werden.
Bevorzuge ein natives HTML-Element mit der passenden Semantik. button hat bereits die Schaltflächenrolle, daher ist eine Wiederholung überflüssig. Zulässige Überschreibungen hängen vom Element und den Regeln von ARIA in HTML ab; nicht jede Rolle ist überall gültig. Erfülle außerdem die Anforderungen der gewählten Rolle an Namen, Zustände und Struktur.
role="button" allein fügt weder Tastaturbedienung noch Fokussierbarkeit oder Aktionen hinzu. Das Beispiel gruppiert zwei native Optionsfelder (<input type="radio">), ohne ihre Rollen zu überschreiben. Wird eine andere Option gewählt, ändert das Skript die Schriftgröße des Beispieltexts. output enthält die Konsolenausgabe mit den deklarierten Werten von role und aria-label sowie dem sichtbaren Text der Gruppe; der Barrierefreiheitsbaum wird dabei nicht untersucht.
Beispiele
<!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>Ergebnis
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.