Barrierefreiheit, die mit der Handwerkskunst einhergeht
Barrierefreiheit ist kein Compliance-Häkchen, das am Ende angehängt wird; sie ist die Grundlage für die Qualität einer Oberfläche. Das meiste davon ist kostenlos, wenn Sie die Plattform richtig nutzen: native Elemente bringen Tastaturunterstützung mit, echte Labels kündigen sich selbst an, und ein sichtbarer Fokusring ist nur eine CSS-Regel. Wenden Sie diese Prinzipien an, wenn Sie UI-Code entwickeln oder überprüfen, und passen Sie die Korrekturen an das vorhandene Styling-System des Projekts an (Tailwind vs. reines CSS vs. CSS-in-JS).
Gehen Sie bei der Überprüfung zuerst als reiner Tastatur-Benutzer durch die Oberfläche (jeder Ablauf muss ohne Maus funktionieren), dann als Screenreader-Benutzer: Kündigt jedes Steuerelement einen Namen, eine Rolle und seinen Zustand an? Wenn Sie unsicher sind, bevorzugen Sie die Standardlösung der Plattform gegenüber einem individuellen Wiederaufbau, und entfernen Sie ARIA, anstatt es hinzuzufügen.
Die Messung von Kontrastverhältnissen und die Farbkorrektur werden durch den Skill better-colors abgedeckt; die visuelle Textgrößenanpassung und der iOS-Eingabezoom durch better-typography; das räumliche RTL-Layout durch better-layout.
Kurzreferenz
| Kategorie | Wann verwenden |
|---|---|
| Fokus & Tastatur | Fokusringe, Skip-Links, tabindex, Focus-Trapping, APG-Tastaturmuster |
| Semantik & ARIA | Native Elemente zuerst, Button vs. Link, Landmarken, zugängliche Namen, deaktivierte Zustände |
| Formulare | Labels, Autocomplete, Fehlermeldungen, Eingabetypen |
| Screenreader | Visuell verborgener Inhalt, Live-Regionen, Toasts, Alternativtext, SVG |
| Trefferflächen | Zielgrößen, Vergrößerung von Trefferflächen, Kollisionsregeln |
| Bewegung & Zoom | prefers-reduced-motion, Autoplay und zeitgesteuerte UI, 200 % Zoom, Reflow, rem vs. px |
Kernprinzipien
1. Native Elemente zuerst
Die erste Regel von ARIA: Verwenden Sie ARIA nicht, wenn ein natives Element existiert. <button> für Aktionen, <a href> für Navigation (es muss Cmd-/Strg-/Mittelklick unterstützen), niemals <div onClick>. Kein ARIA ist besser als schlechtes ARIA.
2. Sichtbare Fokusringe
Stylen Sie :focus-visible, nicht bloß :focus, damit Tastaturbenutzer einen Ring sehen und Mausbenutzer in der Regel nicht. Bevorzugen Sie den unveränderten Fokusindikator des Browsers. Wenn das Design einen benutzerdefinierten Ring erfordert, verwenden Sie einen Projekt-Fokus-Token oder eine andere explizite Farbe und überprüfen Sie den vollständigen Indikator gegen jede angrenzende Farbe, die er kreuzt; currentColor ist nur nach derselben Prüfung akzeptabel. Verwenden Sie mindestens einen durchgehenden Umfang von 2px oder eine gleichwertige sichtbare Fläche. Verwenden Sie niemals outline: none ohne einen geprüften Ersatz, und bewahren Sie die Systemfarben im Forced-Colors-Modus.
3. Vollständige Tastaturunterstützung
Jede Pointer-Interaktion benötigt einen Tastaturpfad, der den ARIA-APG-Mustern folgt: Escape schließt Overlays, Pfeiltasten bewegen sich innerhalb zusammengesetzter Widgets (Tabs, Menüs, Listboxen), Tab bewegt sich zwischen Widgets, Eingabe und Leertaste aktivieren. Nur tabindex="0" (in die natürliche Tab-Reihenfolge einfügen) und tabindex="-1" (programmatischer Fokus), niemals positive Werte, die die natürliche Reihenfolge stören. Zusammengesetzte Widgets verwenden Roving-Tabindex: Das aktive Element ist 0, alle anderen -1.
4. Fokus einfangen und wiederherstellen
Modals setzen inert auf den Hintergrundinhalt, bewegen den Fokus beim Öffnen ins Innere und geben den Fokus beim Schließen an das auslösende Element zurück. Fügen Sie overscroll-behavior: contain hinzu, damit der Hintergrundinhalt nicht scrollt.
5. Mindestgröße der Trefferfläche
Der WCAG-2.5.8-Level-AA-Ausgangswert ist ein 24×24-CSS-Pixel-Ziel oder eine seiner definierten Ausnahmen (Abstand, äquivalentes Steuerelement, Inline, User-Agent, essentiell). Zur einfacheren Aktivierung streben Sie in Touch-Kontexten 44×44px und in Desktop-Oberflächen 40×40px an, wenn es die Dichte erlaubt. Erweitern Sie mit einem Pseudo-Element, wenn das sichtbare Element kleiner bleiben soll. Lassen Sie niemals zu, dass erweiterte Trefferflächen überlappen.
6. Jedes Steuerelement beschriften und typisieren
Jedes Eingabefeld erhält ein <label for> oder ein umschließendes <label>; ein Platzhalter ist niemals ein Label, und Label und Steuerelement teilen sich ein Trefferziel: keine toten Zonen zwischen einer Checkbox und ihrem Text. Fügen Sie autocomplete mit einem aussagekräftigen name hinzu, sowie den korrekten type und inputmode für die Tastatur. Blockieren Sie niemals das Einfügen; Benutzer fügen Passwörter und Einmalcodes ein.
7. Fehler, die sich ankündigen
Halten Sie den Absenden-Button aktiviert, bis die Anfrage startet, deaktivieren Sie ihn dann mit einem Spinner, während Sie das ursprüngliche Label beibehalten. Validieren Sie beim Absenden: Markieren Sie fehlschlagende Felder mit aria-invalid="true", verweisen Sie mit aria-describedby auf den inline-Fehlertext, und setzen Sie den Fokus auf das erste ungültige Feld. Verwenden Sie natives disabled, wenn ein natives Steuerelement wirklich nicht verfügbar ist. Verwenden Sie aria-disabled="true" nur, wenn Fokussierbarkeit oder Auffindbarkeit beabsichtigt ist; blockieren Sie dann Pointer-, Tastatur- und Formularverhalten im Code und stylen Sie den Zustand explizit.
8. Zugängliche Namen überall
Reine Symbol-Buttons benötigen ein beschreibendes aria-label. Sichtbarer Label-Text muss im zugänglichen Namen erscheinen. Dekorative Elemente erhalten aria-hidden="true", niemals auf einem fokussierbaren Element.
9. Nicht nur auf Farbe verlassen
Status benötigt ein redundantes Signal: Symbol, Text oder Unterstreichung zusätzlich zur Farbe. Bestimmen Sie, welche WCAG-Kontrastanforderung auf den Inhalt und Zustand zutrifft, und verwenden Sie dann better-colors, um das gerenderte Vordergrund-/Hintergrundpaar zu messen. Wenn der Kontrast nicht ausreicht, melden Sie das Paar und die Anforderung, die es nicht erfüllt; ändern Sie die Farben des Projekts nicht, ohne gefragt zu werden.
10. prefers-reduced-motion respektieren
Verpacken Sie Bewegungen in @media (prefers-reduced-motion: no-preference), sodass sie Opt-in sind. Ersetzen Sie bei reduzierter Bewegung Folien und Skalierungen durch Deckkraft-Überblendungen; unterbinden Sie Parallax-Effekte und Autoplay vollständig. Unabhängig von der Einstellung: Automatisch abspielende Medien benötigen eine sichtbare Pause-Steuerung, und Toasts, die Aktionen oder Fehler enthalten, bleiben bis zum Schließen bestehen.
11. Dynamische Inhalte ankündigen
Verwenden Sie aria-describedby für feldspezifische Validierung, eine höfliche Live-Region (role="status") für nicht dringende Aktualisierungen, die nicht an ein Steuerelement gebunden sind (z. B. Toasts oder Ergebnisanzahlen), und role="alert" nur für dringende Fehler, die nicht an ein Steuerelement gebunden sind. Für zuverlässige wiederholte höfliche Ansagen rendern Sie eine stabile leere Region, bevor Sie ihren Text aktualisieren; dynamisch eingefügte Alarme haben unterschiedliche Unterstützung und müssen mit den Ziel-Screenreadern getestet werden.
12. Alternativtext nach Zweck
Dekorative Bilder erhalten alt="", informative Bilder beschreiben die Bedeutung, funktionale Bilder beschreiben die Aktion: Ein Suchsymbol-Button hat alt="Suche", nicht alt="Lupe".
13. Struktur ist Navigation
Verwenden Sie Überschriften, die ihre Abschnitte beschreiben und eine kohärente Gliederung bilden; eine h1 auf Seitenebene und korrekt verschachtelte Ebenen sind der empfohlene Standard, nicht isolierte WCAG-Bestehen/Nichtbestehen-Regeln. Machen Sie eine sichtbare primäre <main>-Landmarke zugänglich. Wenn wiederholte Navigation oder Chrome ihr vorausgeht, machen Sie einen „Zum Inhalt springen“-Link zum ersten fokussierbaren Element. Verankerte Überschriften erhalten scroll-margin-top.
14. Zoom und Textgrößenänderung überstehen
Die Seite muss bei 200 % Zoom und Reflow bei 320px Breite ohne horizontales Scrollen funktionieren. Verwenden Sie min-height anstelle von fester height für Textcontainer, bevorzugen Sie rem-Breakpoints, wo sie zu den Codebase-Konventionen passen, und halten Sie das Viewport-Meta davon ab, den Zoom des Lesers zu begrenzen.
Häufige Fehler
| Fehler | Korrektur |
|---|---|
outline: none zum Entfernen des Fokusrings | Stattdessen :focus-visible stylen; Mausklicks zeigen ihn nicht an |
| Benutzerdefinierte Fokusfarbe wird als überall funktionierend angenommen | Überprüfen Sie den vollständigen Indikator gegen jede angrenzende Farbe und im Forced-Colors-Modus |
<div onClick> für einen Button oder Link | <button> für Aktionen, <a href> für Navigation |
| Platzhalter als einziges Label verwendet | Fügen Sie ein sichtbares <label for> hinzu; Platzhalter verschwinden bei Eingabe |
Positiver tabindex zur Korrektur der Fokusreihenfolge | Korrigieren Sie die DOM-Reihenfolge; verwenden Sie nur 0 und -1 |
| Wiederholte höfliche Aktualisierung wird inkonsistent angekündigt | Halten Sie eine stabile leere Statusregion und aktualisieren Sie ihren Text; testen Sie die Ziel-Screenreader |
assertive-Live-Region für einen routinemäßigen Toast | Verwenden Sie polite; reservieren Sie assertive für Fehler |
aria-hidden="true" auf einem fokussierbaren Element | Entfernen Sie es oder machen Sie das Element nicht fokussierbar |
| Funktionssymbol-Alt-Text beschreibt das Bild | Beschreiben Sie die Aktion: alt="Suche", nicht alt="Lupe" |
| Absenden deaktiviert, bis das Formular gültig ist | Halten Sie es aktiviert; validieren Sie beim Absenden und fokussieren Sie den ersten Fehler |
Ausgabeformat für Überprüfungen
Verwenden Sie dieses Format nur, wenn der Benutzer nach einer eigenständigen Barrierefreiheits-Überprüfung fragt. Wenn better-interface die Überprüfung orchestriert, liefern Sie dieser Fähigkeit Domänenbelege und Erkenntnisse und lassen Sie deren Ausgabeformat, Schweregradskala, Konsolidierungsregeln, Obergrenze und Urteil Vorrang haben.
Präsentieren Sie die eigenständige Überprüfung in zwei Teilen.
Erkenntnisse
Gruppieren Sie alle bestätigten Erkenntnisse nach Prinzip. Verwenden Sie eine Markdown-Tabelle mit den Spalten Schweregrad, Ort, Vorher, Nachher und Warum. Verwenden Sie niemals separate „Vorher:“ / „Nachher:“-Zeilen.
- Schweregrad:
HIGHverhindert eine Aufgabe, verbirgt Inhalte vor assistiver Technologie oder verursacht einen systemischen Barrierefreiheitsfehler;MEDIUMmacht eine Interaktion erheblich schwieriger;LOWist isolierte Nachbesserung. - Ort: Zitieren Sie
pfad/zu/datei:zeile. Wenn das Artefakt keine Quelldateien hat, zitieren Sie stattdessen den genauen Bildschirm und die Komponente. - Vorher / Nachher: Zeigen Sie die aktuelle Implementierung und einen umsetzbaren Ersatz.
- Warum: Nennen Sie das verletzte Prinzip und seine Auswirkung auf den Benutzer.
Konsolidieren Sie ein wiederholtes systemisches Problem in einer Zeile und listen Sie jeden betroffenen Ort auf. Lassen Sie Prinzipien ohne Erkenntnisse weg.
Beispiel
Zugängliche Namen überall
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| HIGH | src/Dialog.tsx:42 | <button><XIcon /></button> | aria-label="Schließen" hinzufügen; Symbol mit aria-hidden="true" markieren | Das reine Symbolsteuerelement hat keinen zugänglichen Namen |
| HIGH | src/Nav.tsx:18 | <a href="/settings"><GearIcon /></a> | aria-label="Einstellungen" hinzufügen | Das Linkziel ist für Screenreader nicht verfügbar |
Sichtbare Fokusringe
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| HIGH | src/button.css:12 | button:focus { outline: none; } | button:focus-visible { outline: 2px solid; outline-offset: 2px; } | Tastaturbenutzer können den Fokus nicht sehen |
| HIGH | src/Menu.tsx:31 | focus:outline-none | focus-visible:outline-2 focus-visible:outline-offset-2 | Die Menünavigation hat keinen sichtbaren Fokusindikator |
Fehler, die sich ankündigen
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| HIGH | src/EmailField.tsx:27 | Fehler wird nur als border-red-500 angezeigt | aria-invalid="true" + aria-describedby="email-error" mit inline-Fehlertext hinzufügen | Farbe allein erklärt oder kündigt den Fehler nicht an |
| MEDIUM | src/SignupForm.tsx:64 | Absenden-Button deaktiviert, bis das Formular gültig ist | Absenden-Button aktiviert lassen; bei Fehler das erste ungültige Feld fokussieren | Eine deaktivierte Aktion verbirgt, was behoben werden muss |
Mindestgröße der Trefferfläche
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| MEDIUM | src/Toolbar.tsx:22 | size-4 reiner Symbol-Button | Trefferfläche auf 44×44px erweitern mit after:absolute after:size-11 | Das Ziel ist zu klein für zuverlässige Touch-Eingabe |
Überprüfung und Urteil
Nach den Erkenntnissen:
- Überprüfung: Listen Sie die genauen durchgeführten Prüfungen und ihre beobachteten Ergebnisse auf, einschließlich Tastaturnavigation, Inspektion zugänglicher Namen und Screenreader- oder automatisierte Prüfungen, sofern zutreffend. Wenn eine Prüfung nicht durchgeführt wurde, geben Sie an, was noch überprüft werden muss.
- Urteil:
Blockieren, wenn eineHIGH-Erkenntnis verbleibt,Änderungen erforderlich, wenn nurMEDIUM- oderLOW-Erkenntnisse verbleiben, undGenehmigennur, wenn keine umsetzbaren Erkenntnisse mehr vorhanden sind.
Wenn es keine Erkenntnisse gibt, lassen Sie die Tabellen weg, geben Sie „Keine umsetzbaren Barrierefreiheitserkenntnisse“ an, melden Sie die Überprüfung und enden Sie mit Genehmigen.