Zum Inhalt springen
SilktideHilfe

Ungültige ARIA-Rolle

Silktide prüft jedes role-Attribut auf Ihren Seiten gegen die Liste der Rollen, die der ARIA‑Standard definiert. Eine Rolle, die falsch geschrieben, erfunden, leer oder für den internen Gebrauch reserviert ist, wird von Browsern stillschweigend ignoriert – die beabsichtigte Bedeutung des Elements erreicht die Menschen, die darauf angewiesen sind, daher nicht.

<!-- Problem: "buton" ist keine echte Rolle, daher bleibt dieses div bedeutungslos -->
<div role="buton" tabindex="0">Speichern</div>

<!-- Lösung: Eine gültige Rolle verwenden (oder besser, ein echtes button-Element) -->
<button>Speichern</button>

Warum das wichtig ist

Eine -Rolle teilt mit, was ein Element ist – eine Schaltfläche, ein Tab, ein Dialog. Ist die Rolle ungültig, verwerfen Browser sie: Ein gibt dort nur normalen Text wieder, wo der Autor eigentlich ein Steuerelement vorgesehen hat; Nutzer haben womöglich keine Möglichkeit zu erkennen, dass das Element überhaupt bedienbar ist. Weil die Seite für sehende Mausnutzer normal aussieht und funktioniert, bleiben diese Fehler ohne Tests oft unbemerkt.

So beheben Sie das Problem

  1. Beheben Sie Tippfehler, damit die Rolle einer echten ARIA‑Rolle entspricht (vollständige Liste) – zum Beispiel role=\"navigation\", nicht role=\"nav\".
  2. Ersetzen Sie abstrakte Rollen (widget, composite, landmark, section und ähnliche) durch eine konkrete Rolle – abstrakte Rollen dienen nur der Strukturierung des Standards und dürfen nicht in Seiten verwendet werden.
  3. Entfernen Sie leere role=\"\"-Attribute.
  4. Wo ein natives -Element die richtige Bedeutung bereits mitbringt (<button>, <nav>, <main>), bevorzugen Sie dieses und entfernen Sie das role-Attribut ganz.

Wie Silktide dies prüft

  1. Alle Elemente auf der Seite mit einem role-Attribut finden.
  2. Leere role-Werte melden.
  3. Jedes Wort im role-Wert gegen die in ARIA 1.2 definierten Rollen prüfen. Rollen aus den Erweiterungen für Digital Publishing (doc-) und Graphics (graphics-) werden akzeptiert.
  4. Wörter melden, die keiner definierten Rolle entsprechen, sowie Wörter, die eine abstrakte Rolle benennen.

Fehlerbehebung

Die Rolle enthält mehrere Wörter

Ein role-Attribut kann mehrere Rollen als Ersatz (Fallbacks) auflisten; Browser verwenden die erste, die sie erkennen. Silktide meldet jedes ungültige oder abstrakte Wort in der Liste, damit Sie auch die Fallbacks bereinigen können.

Diese Prüfung meldet nichts, obwohl ich Ergebnisse erwarte

ARIA-Prüfungen können pro Website deaktiviert werden. Prüfen Sie die erweiterten Einstellungen der Website.

Mehr erfahren

Zuletzt aktualisiert

War diese Seite hilfreich?