Abschnitt 20 · Lektion 4
Barrierefreiheit mit JavaScript
Auf dem Bildschirm sehen beide Fassungen in dieser Lektion gleich aus. Den Unterschied merkt man erst, wenn jemand die Maus weglegt oder sich die Seite vorlesen lässt. Wer ein gebrochenes Handgelenk hat, bedient eine Woche lang alles mit der Tastatur. Was ohne Maus geht, geht meistens auch mit Screenreader, und deshalb ist die Tastatur schon die halbe Miete.
Was JavaScript kaputtmachen kann
Drei Dinge passieren immer wieder, und alle drei entstehen erst durch Code.
- Ein
divbekommt einen Klick-Handler und sieht danach aus wie ein Button. - Ein Panel wird eingeblendet, und der Fokus bleibt irgendwo dahinter stehen.
- Eine Meldung erscheint auf dem Bildschirm, und wer sie nicht sieht, erfährt nie davon.
Das richtige Element nehmen
<p>Zum Ausprobieren erst auf die Seite klicken, dann Tabulatortaste und Enter.</p>
<div id="falsch" class="button">Ich bin ein div</div>
<button id="richtig" class="button" type="button">Ich bin ein button</button>
<p id="protokoll">Noch nichts passiert.</p> body {
font-family: system-ui, sans-serif;
padding: 1rem;
}
.button {
display: block;
margin-bottom: 8px;
padding: 8px 12px;
border: 1px solid #57534e;
border-radius: 6px;
background: #f5f5f4;
font: inherit;
cursor: pointer;
} const protokoll = document.getElementById("protokoll");
function melden(wer) {
protokoll.textContent = `${wer} wurde ausgelöst.`;
console.log(wer, "wurde ausgelöst.");
}
// Beide reagieren auf einen Mausklick, der Code ist derselbe.
document.getElementById("falsch").addEventListener("click", () => {
melden("Das div");
});
document.getElementById("richtig").addEventListener("click", () => {
melden("Der button");
});
// Mit Tab landet man nur auf dem zweiten. Auf dem ersten
// landet man gar nicht, und ohne Fokus gibt es auch keine
// Eingabetaste, die etwas auslöst. Ein Klick auf die Seite gibt ihr den Fokus. Ein Tab landet dann auf dem button, nie auf dem div. Gemessen ist das ein Tab, denn das div steht gar nicht in der Reihenfolge. Es wird nicht übersprungen, es kommt einfach nicht vor. Noch ein Tab führt aus der Seite heraus, weil es nur dieses eine bedienbare Element gibt.
Ein div ist ein Behälter ohne Bedeutung. Es steht nicht in der Reihenfolge der bedienbaren Elemente, es meldet sich einem Screenreader nicht als Button, und es reagiert auf keine Taste.
Ein button bringt all das mit, ohne dass du eine Zeile dafür schreibst. Er ist mit Tab erreichbar, reagiert auf Enter und die Leertaste, meldet sich als „Schaltfläche“ und wird beim Deaktivieren korrekt übersprungen.
Man kann ein div nachrüsten, mit tabindex="0", role="button" und einem eigenen keydown-Handler für zwei Tasten. Das sind vier Zeilen für etwas, das ein einziges Wort im Markup umsonst liefert. Und wer eine davon vergisst, merkt es nicht. Ich nehme deshalb das Element, das gemeint ist, a bei einem Ziel, input bei einer Eingabe und label bei einer Beschriftung.
Den Fokus führen
<button id="oeffnen" type="button" aria-expanded="false" aria-controls="panel">
Einstellungen
</button>
<div id="panel" hidden>
<p><button id="erster" type="button">Erster Eintrag</button></p>
<p><button id="zweiter" type="button">Zweiter Eintrag</button></p>
</div> body {
font-family: system-ui, sans-serif;
padding: 1rem;
}
#panel {
margin-top: 8px;
padding: 8px;
border: 1px solid #d6d3d1;
} const oeffner = document.getElementById("oeffnen");
const panel = document.getElementById("panel");
const erster = document.getElementById("erster");
function oeffnen() {
panel.hidden = false;
oeffner.setAttribute("aria-expanded", "true");
// Erst einblenden, dann fokussieren. Ein verstecktes
// Element nimmt keinen Fokus an.
erster.focus();
}
function schliessen() {
panel.hidden = true;
oeffner.setAttribute("aria-expanded", "false");
// Der Fokus muss zurück. Sonst steht er im Nichts, man sieht
// nicht mehr, wo man ist, und die nächste Tabulatortaste geht
// irgendwo hinter dem Panel weiter.
oeffner.focus();
}
oeffner.addEventListener("click", () => {
if (oeffner.getAttribute("aria-expanded") === "true") {
schliessen();
} else {
oeffnen();
}
});
panel.addEventListener("keydown", (ereignis) => {
if (ereignis.key === "Escape") {
schliessen();
}
});
// Wohin der Fokus springt, sieht man nicht immer. Dieser
// Listener schreibt jeden Wechsel in die Console.
document.addEventListener("focusin", (ereignis) => {
console.log("Fokus auf:", ereignis.target.id);
}); Alles, was ein- und ausgeblendet wird, braucht eine Fokusverwaltung. Sonst steht der Fokus nach dem Öffnen eines Menüs weiter auf dem Button, und wer das Menü bedienen will, muss selbst hineintabben. Liegt das Panel im Dokument woanders, etwa ganz am Ende, findet man es mit der Tastatur kaum.
Drei Regeln reichen für die meisten Fälle.
- Beim Öffnen kommt der Fokus hinein, meist auf den ersten bedienbaren Eintrag, und zwar nachdem das Element sichtbar ist. Ein verstecktes Element nimmt keinen Fokus an, und ein
focus()davor läuft ins Leere. - Beim Schließen geht der Fokus zurück auf das Element, von dem aus geöffnet wurde. Sonst ist die Stelle im Dokument verloren.
- Escape schließt. Das ist eine Erwartung, die aus jedem Betriebssystem kommt, und sie kostet vier Zeilen.
Den Fokus sieht man als Einziges in dieser Lektion nicht. Deshalb hängt im zweiten Beispiel ein Listener auf focusin, der jeden Wechsel in die Console schreibt. Ein Klick auf „Einstellungen“ ergibt Fokus auf: erster, weil oeffnen() den Fokus ins Menü setzt. Steht erster.focus() über panel.hidden = false, fehlt diese Zeile. Der Aufruf hat dann nichts getan, nichts gemeldet und nichts geworfen.
Danach in der Eingabezeile der Console nachzufragen, führt hier in die Irre. Der Klick hinein nimmt der Seite den Fokus, und document.activeElement ist danach der body, ganz gleich, wo der Fokus vorher lag.
In der Aufgabe zu dieser Lektion wird das mitgeprüft. Stehen in oeffnen() die beiden Zeilen vertauscht, bleiben nach einem Klick auf Prüfen sieben von acht Prüfungen grün. Rot wird die dritte, „Der Fokus liegt auf dem ersten Eintrag“. Der Sprung ins Menü fehlt, und auf dem Bildschirm ändert sich nicht das Geringste.
Dazu gehört aria-expanded am auslösenden Button. Daran erkennt ein Screenreader, ob gerade offen oder geschlossen ist. Der Wert ist ein Text, "true" oder "false" in Anführungszeichen. In Lektion 13.4 gab es dasselbe Muster schon einmal, dort hieß es aria-invalid und stand an einem Feld mit Fehler.
Änderungen ankündigen
<p><button id="speichern" type="button">Speichern</button></p>
<h2>Richtig: die Region steht schon da</h2>
<p id="status" aria-live="polite"></p>
<h2>Falsch: die Region entsteht erst mit der Meldung</h2>
<div id="behaelter"></div> body {
font-family: system-ui, sans-serif;
padding: 1rem;
}
h2 {
font-size: 1rem;
margin-bottom: 0;
}
#status,
#behaelter {
min-height: 1.5rem;
} const status = document.getElementById("status");
const behaelter = document.getElementById("behaelter");
let laeufe = 0;
document.getElementById("speichern").addEventListener("click", () => {
laeufe = laeufe + 1;
// Richtig: die Region ist beim Laden da, der Screenreader
// beobachtet sie, und nur der Text ändert sich.
status.textContent = `Gespeichert (${laeufe}).`;
// Falsch: hier entsteht die Region gerade erst. Was schon
// beim Einfügen dasteht, gilt nicht als Änderung und wird
// deshalb meist nicht vorgelesen.
behaelter.replaceChildren();
const meldung = document.createElement("p");
meldung.setAttribute("aria-live", "polite");
meldung.textContent = `Gespeichert (${laeufe}).`;
behaelter.append(meldung);
}); Ein Screenreader liest die Seite von oben nach unten vor. Ändert sich danach irgendwo etwas, bekommt er davon nichts mit. Außer die Stelle ist als Live-Region markiert.
aria-live="polite" meldet eine Änderung am Text, ohne etwas zu unterbrechen. Das ist der richtige Wert für fast alles, für Statusmeldungen, Suchergebnisse und Zähler. aria-live="assertive" unterbricht sofort und gehört nur an echte Fehlermeldungen. Im geprüften Formular in Abschnitt 13 stand role="status" an der Meldung, und das ist dieselbe Sache mit eingebautem aria-live="polite". Beides ist richtig.
Im zweiten Teil des Beispiels steht der Punkt, an dem alles hängt. Die Region muss beim Laden schon im Markup stehen, denn beobachtet wird sie erst ab dem Moment, in dem es sie gibt. Fügst du sie zusammen mit ihrem Inhalt ein, gibt es nie eine Änderung, nur ein neues Element, und das wird in der Regel nicht vorgelesen.
Deshalb steht von Anfang an ein leeres p mit aria-live="polite" in der Seite, und der Code setzt nur noch textContent.
Mit der Tastatur durch die eigene Seite
Barrierefreiheit sieht man nicht. Auf dem Bildschirm sieht das kaputte div genauso aus wie der richtige button.
Ich lege deshalb die Maus weg und gehe mit Tab durch die Seite, das dauert zwei Minuten. Dabei zählt, ob jede Stelle erreichbar ist und ob man sieht, wo man gerade ist. Lässt sich alles auslösen, was sich anklicken lässt? Und kommt man aus einem geöffneten Panel wieder heraus?
Wo der Fokus gerade liegt, zeigt der Fokusring. Manchmal fehlt er, weil ein Stylesheet ihn weggenommen hat, oder eine Stelle ist unklar. Dann hilft der Listener auf focusin aus dem zweiten Beispiel, der jeden Wechsel in die Console schreibt, auch wenn auf dem Bildschirm kein Rahmen zu sehen ist. Wo du dabei hängen bleibst, sitzt der Fehler.
In der Aufgabe wird ein Aufklapp-Menü ohne Maus bedienbar, mit Fokus hinein und zurück, Escape und einer Meldung.
Zum Mitnehmen
Das richtige Element bringt Tastatur und Rolle mit. Den Fokus führt der eigene Code, hinein und wieder zurück, und eine Meldung wird nur in einer Region angesagt, die schon beim Laden dasteht.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.