ARIA Authoring Practices Guide

Die ARIA-Spezifikation definiert ein Vokabular aus Rollen, Zuständen und Eigenschaften. Der ARIA Authoring Practices Guide erklärt, wie diese in der Praxis eingesetzt werden: welche Tastaturinteraktionen jedes Muster erfordert, wie der Fokus innerhalb eines Widgets wandert, was bei Zustandsänderungen angekündigt werden soll und wie das DOM aufgebaut sein muss.

Was der APG enthält

Der APG dokumentiert die kanonische Implementierung jedes Widget-Musters, für das die ARIA-Spezifikation konzipiert wurde:

• Comboboxes (das Autocomplete-Muster mit komplexem Tastaturverhalten, das fast immer falsch implementiert wird).
• Dialoge — modal und nicht-modal, mit vollständiger Fokussperrung und Rückgabe des Fokus beim Schließen.
• Disclosure-Widgets (das einfache Einblenden-/Ausblenden-Muster).
• Menüs und Menüleisten — Varianten, die Pfeilnavigation erfordern, nicht bloß Tab.
• Tabs — Tab/Tabpanel-Paare mit Tastatur-Pfeilnavigation und Semantik für automatische oder manuelle Aktivierung.
• Treeviews — hierarchische Navigation im Stil eines Dateibaums.
• Listboxes — Einfach- und Mehrfachauswahl.
• Spin-Buttons, Schieberegler, Karussells und ein Dutzend weitere Muster.

Jede Musterseite besteht aus drei Teilen: einem funktionsfähigen Live- Beispiel, der Tabelle der Tastaturinteraktionen und den präzise aufgeführten ARIA-Attributen. Darüber hinaus enthält der APG Landmark-Muster — Empfehlungen zu <header>, <nav>, <main> und den zugehörigen ARIA-Rollen — sowie einen Abschnitt zu Anti-Mustern, der erläutert, was zu vermeiden ist.

Wann der APG heranzuziehen ist

Der APG ist am nützlichsten, wenn ein Widget entwickelt werden soll, für das kein natives HTML-Element existiert. Bevor eine einzige Zeile Code geschrieben wird, empfiehlt es sich zu prüfen, ob der APG das gesuchte Muster enthält. In der Regel gilt:

• Die erforderlichen Tastaturinteraktionen sind bereits spezifiziert.
• Die DOM-Struktur ist bereits dokumentiert.
• Die ARIA-Attribute sind bereits ausgearbeitet.

Wer diesen Schritt überspringt, liefert häufig „barrierefreie“ Widgets, die Screenreader auf eine Weise verwirren, die kein automatisiertes Werkzeug erkennt. Der APG ist der Unterschied zwischen einer Combobox, die für alle funktioniert, und einer, die kompiliert, aber für Screenreader-Nutzende nicht bedienbar ist.

Was der APG ausdrücklich nicht ist

Der APG ist keine normative Spezifikation. Die normativen Dokumente sind die ARIA-Spezifikation selbst und WCAG. Der APG ist ein Leitfaden: ein Widget genau nach APG-Vorgabe zu implementieren ist der empfohlene Weg, jedoch nicht der einzig zulässige. Davon abzuweichen ohne dokumentierten Grund ist allerdings ein Indiz dafür, dass das Muster möglicherweise nicht vollständig verstanden wurde.

Der APG ersetzt auch kein natives HTML. Wenn <select> für ein Dropdown ausreicht, sollte <select> verwendet werden — das APG- Combobox-Muster ist keine Verbesserung, nur weil es komplexer wirkt.