Element per Tastatur nicht erreichbar (keyboard:unreachable)

Die Regel keyboard:unreachable meldet etwas, das sich wie ein Bedienelement verhält – es hat einen Klick-Handler oder eine Rolle wie button oder tab –, auf dem aber nie ein Tab landet und das in Tabs, einer Radiogruppe oder einer Werkzeugleiste auch keine Pfeiltaste erreicht. Mit der Maus funktioniert es, mit der Tastatur kommt man nie hin. Die Lösung ist fast immer das echte Element: <button> für Aktionen, <a href> für Navigation – oder, in einem Widget mit einem Tab-Stopp, die Pfeiltasten, die sein Muster verlangt.

Was die Regel bedeutet

WCAG 2.1.1 verlangt, dass sich alles, was eine Seite ermöglicht, auch per Tastatur erledigen lässt. Native Bedienelemente – Links mit href, Buttons, Formularfelder, <summary> – stehen in der Tab-Reihenfolge und reagieren ohne zusätzlichen Code auf Enter oder Leertaste. Ein <div> oder <span> kann beides nicht: Es bekommt keinen Fokus, und Enter bewirkt nichts – egal, wie es aussieht und was sein Klick-Handler tut.

Eine Rolle allein ändert daran nichts. role="button" lässt Hilfstechnik einen Button ansagen, bringt das Element aber weder in die Tab-Reihenfolge noch zum Reagieren auf Enter oder Leertaste. Das Markup verspricht etwas, das es nicht hält.

Wen es betrifft

Alle, die eine Seite ohne Maus bedienen: Menschen mit motorischen Einschränkungen mit Tastatur, Schalter oder Mundstab, blinde Menschen mit Screenreader und Menschen mit Sprachsteuerung, die oft über dieselben fokussierbaren Elemente arbeitet. Ist ausgerechnet das Element nicht erreichbar, das ein Produkt öffnet, in den Warenkorb legt oder Cookies bestätigt, lässt sich die Aufgabe gar nicht abschließen.

Warum die Prüfung anschlägt

  • Klickbare Karten – ein <div onclick> um einen Teaser oder ein Produkt, ohne Link darin.
  • Icon-Buttons aus <span> oder <i> mit Klick-Handler: Schließen, Menü, Suche.
  • Halbfertige ARIA-Widgets: role="tab", role="menuitem" oder role="option" ohne tabindex und ohne Tastaturbedienung.
  • Tabs, Radiogruppen oder Werkzeugleisten mit einem Tab-Stopp und ohne Pfeiltasten: Die inaktiven Elemente stehen wie im Muster vorgesehen mit tabindex="-1" außerhalb der Tab-Reihenfolge, aber nichts bringt den Fokus zu ihnen. Native <button>-Tabs scheitern genauso.
  • Ein Widget ganz ohne Tab-Stopp: Jeder Tab oder jedes Radio hat tabindex="-1", der Fokus kommt gar nicht erst hinein.
  • tabindex="-1" an einem Bedienelement, das erreichbar sein sollte – oft aus einem Muster kopiert, das den Fokus per Skript verwaltet.
  • Cookie-Banner und Chat-Starter von Drittanbietern, die nur auf Mausklicks hören.

So beheben Sie es

Ersetzen Sie den Stellvertreter durch das Element, das die Aufgabe schon kann. Fokus, Enter, Leertaste und die richtige Rolle bekommen Sie dann geschenkt.

<!-- Vorher: eine Karte, die sich nur mit der Maus öffnen lässt -->
<div class="produkt-karte" onclick="location.href = '/produkte/schreibtischlampe/'">
  <img src="/img/schreibtischlampe.jpg" alt="">
  <h2>Schreibtischlampe</h2>
  <p>49,00 €</p>
</div>
<!-- Nachher: die Überschrift enthält einen echten Link; CSS kann ihn über die Karte ziehen -->
<div class="produkt-karte">
  <img src="/img/schreibtischlampe.jpg" alt="">
  <h2><a href="/produkte/schreibtischlampe/">Schreibtischlampe</a></h2>
  <p>49,00 €</p>
</div>

Dasselbe bei einem Icon, das etwas auslöst:

<!-- Vorher: als Button angesagt, aber kein Tab erreicht es -->
<span class="icon-schliessen" role="button" aria-label="Schließen" onclick="panelSchliessen()">×</span>
<!-- Nachher: ein echter Button -->
<button type="button" class="icon-schliessen" aria-label="Schließen" onclick="panelSchliessen()">×</button>

Können Sie das Element wirklich nicht austauschen, braucht es tabindex="0", einen Handler für Enter (bei Buttons auch Leertaste) und die passende Rolle – drei Dinge, die das native Element auf einmal mitbringt.

So prüfen Sie es von Hand

  1. Drücken Sie Tab vom Seitenanfang an und notieren Sie jedes Bedienelement, das den Fokus bekommt.
  2. Vergleichen Sie mit allem, was sich anklicken lässt: Karten, Icons, Tabs, Akkordeons, Slider, Cookie-Buttons.
  3. In Tabs, Radiogruppen, Werkzeugleisten, Menüs und Listboxen erreicht Tab ein Element. Drücken Sie dort die Pfeiltasten und prüfen Sie, ob der Fokus – oder die hervorgehobene Option – zu jedem der anderen wandert.
  4. Jedes übersprungene Bedienelement ist ein Fund. Drücken Sie bei jedem besuchten Enter (bei Buttons auch Leertaste) und prüfen Sie, ob es funktioniert.
  5. Der Barrierefreiheitsbaum in den Entwicklertools zeigt, ob ein Element fokussierbar ist und welche Rolle es hat.

Zugehöriges WCAG-Kriterium

2.1.1 Tastatur, Stufe A. Verwandt: 4.1.2 Name, Rolle, Wert, weil ein klickbares <div> auch keine Rolle hat, und 2.4.3 Fokus-Reihenfolge.

So meldet Reviseberg diese Regel

Diese Regel stammt vom Tastatur-Agenten von Reviseberg, nicht aus axe-core. Nachdem er die Nutzerreise, die Sie festlegen, mit echten Tastendrücken durchlaufen hat, sucht der Agent nach Elementen, die sich als Bedienelement ausgeben – ein onclick-Attribut oder eine Rolle wie button, link, checkbox, radio, tab, menuitem, switch oder option –, die sichtbar sind, aber weder von Natur aus fokussierbar noch mit einem tabindex von 0 oder mehr versehen. Jedes meldet er mit dem Hinweis „This div behaves like a control but cannot be reached with the keyboard“, dem Selektor und dem Grund, warum es interaktiv wirkte.

Tabs, Radiogruppen, Werkzeugleisten, Menüs und Listboxen sind mit Absicht anders gebaut: Tab erreicht ein Element, die Pfeiltasten wandern zu den übrigen, die mit tabindex="-1" außerhalb der Tab-Reihenfolge stehen oder per aria-activedescendant angesteuert werden. Für ein Element einer tablist, radiogroup, toolbar, eines menu, einer menubar oder listbox, das außerhalb der Tab-Reihenfolge steht, setzt der Agent deshalb den Fokus auf den Tab-Stopp des Widgets und drückt die Pfeiltasten nach rechts, nach unten, nach links und nach oben – echte Tastendrücke, wie beim Durchlauf:

  • Ein Element, das eine Pfeiltaste erreicht, wird nicht gemeldet. Das Protokoll nennt die Taste, die hingeführt hat.
  • Ein Element, das keine Pfeiltaste erreicht, wird gemeldet, mit den versuchten Tasten. Das gilt auch für einen nativen <button tabindex="-1">: Ein Button außerhalb der Tab-Reihenfolge steht außerhalb.
  • Steht nichts im Widget in der Tab-Reihenfolge, wird jedes Element gemeldet, ohne dass eine Taste gedrückt wird: Kein Tab kommt hinein, also hat keine Pfeiltaste einen Ausgangspunkt.
  • Wo der Agent keine Pfeiltasten drückt – in einem Cookie-Banner, dessen datensparsamste Wahl er gleich mit Enter trifft –, wird das Element als offene Frage gemeldet, nicht als Fehler und nie als bestanden. Es erscheint bei den anderen offenen Fragen, nicht in der Liste der Probleme, und kostet keine Punkte.

Was er nicht sieht: Ein Klick-Handler, der mit addEventListener angehängt wurde, hinterlässt keine Spur, die ein Skript auf der Seite nachträglich lesen könnte. Ein so verdrahtetes <div> wird hier nicht gemeldet. Bei einem Crawl aus einem Konto zeichnet eine eigene Prüfung solche Handler auf einer Seite je Template auf, während die Seite sie registriert, und meldet ein Element, das auf einen Klick reagiert, aber von keiner Taste erreicht wird, als keys:click-only. Der Agent meldet bewusst lieber zu wenig, als aus einem Zeiger-Cursor zu raten – das würde jede gestaltete Karte markieren. In einem Widget prüft er, ob die Pfeiltasten jedes Element erreichen – nicht, ob der Fokus dabei sichtbar ist, und nicht, was Enter, Leertaste, Pos1 oder Ende bewirken (bei einem Crawl aus einem Konto meldet keys:no-activation ein eigenes Bedienelement, das auf Enter oder Leertaste nichts tut). Ein sauberes Ergebnis ist hier also kein Beweis, und der Test von Hand bleibt wichtig.

Verwandte Regeln

Tastatur-Agent auf Ihrer Website – kostenloser Bericht

Häufige Fragen

Reicht role="button"?

Nein. Die Rolle ändert, was Hilfstechnik ansagt, nicht, wie sich das Element verhält. Es braucht zusätzlich tabindex="0" und Handler für Enter und Leertaste – oder, einfacher, es ist ein <button>.

Warum nicht einfach tabindex="0" an das div?

Fokus ist noch keine Bedienung: Enter und Leertaste bewirken nichts, bis Sie sie programmieren, und eine Rolle fehlt weiterhin. <button> oder <a href> erledigen alles auf einmal.

Meine inaktiven Tabs haben tabindex="-1". Ist das das Problem?

Nicht, wenn die Pfeiltasten sie erreichen: Das ist das Tabs-Muster, und der Agent drückt die Pfeiltasten vom aktiven Tab aus, bevor er etwas meldet. Er meldet die Tabs, die keine Pfeiltaste erreicht – und, wenn gar kein Tab in der Tab-Reihenfolge steht, jeden Tab.

Warum findet der Agent nicht jedes unerreichbare Element?

Ein mit addEventListener angehängter Handler ist für kein Skript auf der Seite sichtbar. Der Agent meldet, was er belegen kann, statt zu raten.

Findet axe-core das?

Teilweise, aus anderer Richtung: Regeln wie nested-interactive und scrollable-region-focusable fangen verwandte Muster. Ob sich ein klickbares Element per Tab erreichen lässt, zeigt nur die Tastatur.

Quellen

  1. W3C, Understanding SC 2.1.1 Keyboard – https://www.w3.org/WAI/WCAG22/Understanding/keyboard
  2. W3C, ARIA Authoring Practices Guide: Button Pattern – https://www.w3.org/WAI/ARIA/apg/patterns/button/
  3. MDN, ARIA: button role – https://developer.mozilla.org/de/docs/Web/Accessibility/ARIA/Roles/button_role
  4. W3C, Using ARIA: first rule of ARIA use – https://www.w3.org/TR/using-aria/
  5. W3C, ARIA Authoring Practices Guide: Developing a Keyboard Interface – https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/

Sehen Sie, was ein Scan auf Ihrer Website findet

Eine Seite in rund 30 Sekunden, ohne E-Mail. Der vollständige Bericht umfasst bis zu 100 Seiten und einen Tastatur-Durchlauf.