aria-required-attr · WCAG 4.1.2 Name, Role, Value · Stufe AWie Sie das „aria-required-attr“-Problem beheben
Die axe-core-Regel aria-required-attr schlägt fehl, wenn einem Element mit ARIA-Rolle ein für die Rolle erforderliches Attribut fehlt — z. B. role="checkbox" ohne aria-checked. Das Bedienelement legt dann einen unvollständigen Zustand offen. WCAG 2.2 (4.1.2, Stufe A).
Was axe-core prüft
axe-core prüft jede ARIA-Rolle gegen ihre Pflichtattribute und meldet fehlende (z. B. role="slider" ohne aria-valuenow).
Welcher Norm das entspricht
| WCAG 2.2 | 4.1.2 Name, Role, Value (Stufe A) |
| EN 301 549 | 9.4.1.2 |
| BFSG / EAA | BFSG § 12 i. V. m. EN 301 549 · EAA Anhang I |
| Kategorie | ARIA |
Warum es zählt
Eigene Widgets (Toggles, Sterne-Bewertung, Tabs) mit ARIA-Rollen, aber ohne Pflicht-Zustände verwirren Hilfstechnik — der Nutzer weiß nicht, ob ein Toggle an oder aus ist. Sicherer ist meist natives HTML.
Häufige Ursachen
role="checkbox"ohnearia-checkedrole="slider"ohnearia-valuenowrole="combobox"ohnearia-expanded- Handgebaute Widgets, die eine Rolle ohne ihre Zustände kopieren
Wie Sie es beheben
Ergänzen Sie die für die Rolle erforderlichen Attribute und halten Sie sie in JavaScript aktuell — oder besser: nutzen Sie das native HTML-Element (z. B. <input type="checkbox">), das sie mitliefert.
<!-- Fehler -->
<div role="checkbox">Abonnieren</div>
<!-- Besteht (nativ ist am besten) -->
<input type="checkbox" id="sub"><label for="sub">Abonnieren</label>Verwandte Prüfungen
FAQ
Das hängt von der Rolle ab; siehe ARIA-Spezifikation. axe nennt das fehlende im Bericht.
Bevorzugen Sie natives HTML. ARIA-Rollen bringen Verantwortung — alle Pflichtzustände und das Tastaturverhalten müssen Sie selbst verwalten.
Finden Sie jeden solchen Fehler auf Ihrer Seite
Starten Sie einen kostenlosen WCAG 2.2 AA-Scan — echte axe-core-Engine, ohne Anmeldung. Oder ein zeitgestempelter Beweis-Report für 29 €.