Rampsight

Alle Regeln

ARIA

Werte von ARIA-Attributen müssen gültig sein

Warum das wichtig ist

Ein aria-labelledby, das auf eine nicht existierende id zeigt, lässt das Element ganz ohne Namen zurück, und ein ungültiger Zustandswert gilt als nicht vorhanden. Das Markup sieht richtig aus und bewirkt nichts.

So beheben Sie es

  1. Prüfen Sie, ob jede von aria-labelledby, aria-describedby oder aria-controls referenzierte id auf der Seite existiert.
  2. Verwenden Sie genau die erlaubten Werte: true, false, mixed, undefined.
  3. Achten Sie auf komponentenweise erzeugte ids — doppelte oder neu gerenderte ids sind die übliche Ursache.

Im Markup

Fehlerhaft
<input aria-labelledby="email-label">
<!-- no element with id="email-label" -->
Korrekt
<span id="email-label">Email</span>
<input aria-labelledby="email-label">

Die Anforderung dahinter

Diese Regel ist eine Art, die folgenden WCAG-2.2-Erfolgskriterien zu verfehlen. Das W3C, das den Standard herausgibt, erläutert jedes davon:

Weiterführende Quellen

Deque University zu aria-valid-attr-value (öffnet in neuem Tab)

Deque entwickelt axe-core, die quelloffene Prüf-Engine unseres Scanners. Ihre Seite dokumentiert die Regel so, wie die Engine sie umsetzt.

Automatische Prüfungen finden Fehler, die ein Browser nachweisen kann. Ob eine Untertitelspur inhaltlich stimmt, ob ein Alternativtext wirklich hilft oder ob sich eine Seite durchgängig mit der Tastatur bedienen lässt, kann nur ein Mensch beurteilen.