12. November 2026
Barrierefreier modaler Dialog: das W3C-Muster Schritt für Schritt
Ein barrierefreier modaler Dialog ist ein Fenster über der Seite, dessen darunterliegender Inhalt inert wird und das sich sowohl per Tastatur als auch mit assistiven Technologien bedienen lässt. Der ARIA Authoring Practices Guide (APG) des W3C beschreibt genau, wie er sich verhalten soll: Beim Öffnen wandert der Fokus in den Dialog; mit Tab und Umschalt + Tab lässt er sich nicht verlassen; die Escape-Taste schließt ihn; beim Schließen kehrt der Fokus zu dem Element zurück, das ihn geöffnet hat. Im Code trägt der Container die Rolle dialog, das Attribut aria-modal="true" und einen zugänglichen Namen. Dieser Leitfaden geht diese Empfehlungen einzeln durch, einschließlich der Feinheiten, die das W3C zur Platzierung des Fokus und zum Einsatz von aria-modal ergänzt, und schließt mit einem Codebeispiel, das Sie anpassen können.
Was ist ein barrierefreier modaler Dialog laut W3C?
Der APG definiert einen Dialog als Fenster, das über dem Hauptfenster oder einem anderen Dialogfenster liegt. Modal wird er dadurch, dass die Fenster darunter inert sind: Nutzer können nicht mit Inhalten außerhalb des aktiven Dialogs interagieren.
Dieser inerte Inhalt wird typischerweise visuell verdeckt oder abgedunkelt, damit er schwer zu erkennen ist. In manchen Implementierungen schließt jeder Versuch, mit ihm zu interagieren, den Dialog.
Wie nicht-modale Dialoge enthalten auch modale Dialoge ihre eigene Tab-Reihenfolge. Anders als die meisten nicht-modalen Dialoge bietet ein modaler Dialog jedoch keine Möglichkeit, den Tastaturfokus aus dem Fenster zu bewegen, ohne es zu schließen. Für eine kurze, wichtige Meldung, die die Aufmerksamkeit des Nutzers umlenken soll, sieht das W3C einen Sonderfall vor: die Rolle alertdialog, beschrieben in einem eigenen Muster, dem Alert Dialog Pattern.
Fokus beim Öffnen: wohin im modalen Dialog?
Grundregel: Wenn ein Dialog geöffnet wird, wandert der Fokus auf ein Element innerhalb des Dialogs. In der Regel ist das das erste fokussierbare Element. Der APG betont jedoch, dass die beste Platzierung von Art und Umfang des Inhalts abhängt, und nennt mehrere Fälle:
- Strukturierter Inhalt (Listen, Tabellen, mehrere Absätze), der schwer verständlich wäre, wenn er als ein durchgehender Textblock vorgelesen würde: Es ist ratsam, einem statischen Element am Anfang des Inhalts tabindex="-1" zu geben und es zuerst zu fokussieren. So können Nutzer assistiver Technologien den Inhalt leichter lesen, indem sie durch seine Strukturen navigieren. In diesem Fall ist es außerdem ratsam, auf aria-describedby am Container zu verzichten.
- Langer Inhalt, bei dem das Fokussieren des ersten interaktiven Elements den Anfang aus dem sichtbaren Bereich scrollen könnte: Es ist ratsam, einem statischen Element oben im Dialog, etwa dem Titel oder dem ersten Absatz, tabindex="-1" zu geben und es zu fokussieren.
- Letzter Schritt eines schwer umkehrbaren Vorgangs (Daten löschen, eine Finanztransaktion abschließen): Es kann ratsam sein, den Fokus auf die am wenigsten destruktive Aktion zu setzen. Hier wird oft das Alert Dialog Pattern eingesetzt.
- Dialog, der nur Informationen liefert oder einen Vorgang fortsetzt: Es kann ratsam sein, das Element zu fokussieren, das voraussichtlich am häufigsten genutzt wird, etwa eine Schaltfläche OK oder Weiter.
Fokusfalle im modalen Dialog: Tab, Umschalt + Tab und Escape
Der APG bezeichnet jedes Element mit einem tabindex-Wert von null oder größer als „tabbable“ (per Tab erreichbar) und weist darauf hin, dass von Werten größer als 0 dringend abgeraten wird. Bei geöffnetem Dialog soll sich die Tastatur so verhalten:
- Tab: bewegt den Fokus zum nächsten per Tab erreichbaren Element im Dialog. Vom letzten springt er zum ersten.
- Umschalt + Tab: bewegt den Fokus zum vorherigen per Tab erreichbaren Element im Dialog. Vom ersten springt er zum letzten.
- Escape: schließt den Dialog.
<button type="button" id="open-dialog">Konto löschen</button>
<div id="dialog" role="dialog" aria-modal="true"
aria-labelledby="dialog-title" aria-describedby="dialog-desc" hidden>
<h2 id="dialog-title">Konto löschen?</h2>
<p id="dialog-desc">Diese Aktion ist endgültig.</p>
<button type="button" id="cancel">Abbrechen</button>
<button type="button" id="confirm">Löschen</button>
</div>
<script>
const dialog = document.getElementById('dialog');
const cancel = document.getElementById('cancel');
let opener = null;
function tabbables() {
return [...dialog.querySelectorAll('a[href], button, input, select, textarea, [tabindex]')]
.filter(el => !el.disabled && el.tabIndex >= 0);
}
function openDialog(event) {
opener = event.currentTarget; // auslösendes Element merken
dialog.hidden = false;
// Damit aria-modal="true" bleiben darf, muss der Rest der Seite
// für alle Nutzer inert UND visuell verdeckt sein (hier nicht gezeigt).
cancel.focus(); // am wenigsten destruktive Aktion
}
function closeDialog() {
dialog.hidden = true;
if (opener && opener.isConnected) opener.focus(); // Fokus zurückgeben
else document.querySelector('main h1')?.focus(); // Ausweichziel: ein logisches Element (anpassen; ggf. tabindex="-1")
}
dialog.addEventListener('keydown', (e) => {
if (e.key === 'Escape') { closeDialog(); return; }
if (e.key !== 'Tab') return;
const items = tabbables();
const first = items[0], last = items[items.length - 1];
if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
});
document.getElementById('open-dialog').addEventListener('click', openDialog);
cancel.addEventListener('click', closeDialog);
</script>Dialog schließen: wohin kehrt der Fokus zurück?
Wenn der Dialog geschlossen wird, kehrt der Fokus zu dem Element zurück, das ihn aufgerufen hat. Der APG sieht zwei Ausnahmen vor. Erstens: Das auslösende Element existiert nicht mehr; dann wird der Fokus auf ein anderes Element gesetzt, das einen logischen Arbeitsablauf ermöglicht. Zweitens: Die Gestaltung des Ablaufs enthält Bedingungen, die es gelegentlich logischer machen, ein anderes Element zu fokussieren, nämlich wenn es sehr unwahrscheinlich ist, dass Nutzer den Dialog sofort erneut aufrufen müssen, und wenn die im Dialog erledigte Aufgabe direkt mit einem folgenden Schritt zusammenhängt.
Das Beispiel des W3C: Ein Grid hat eine Werkzeugleiste mit einer Schaltfläche zum Hinzufügen von Zeilen. Diese Schaltfläche „Add Rows“ öffnet einen Dialog, der nach der Anzahl der Zeilen fragt. Nach dem Schließen liegt der Fokus in der ersten Zelle der ersten neuen Zeile.
Schließlich wird dringend empfohlen, dass die Tab-Reihenfolge jedes Dialogs ein sichtbares Element mit der Rolle button enthält, das den Dialog schließt, etwa ein Schließen-Symbol oder eine Schaltfläche Abbrechen.
ARIA-Rollen und -Attribute für einen barrierefreien modalen Dialog
Das W3C-Muster legt folgende Rollen, Zustände und Eigenschaften fest:
- Der Dialog-Container hat die Rolle dialog.
- Alle Elemente, die zur Bedienung des Dialogs nötig sind, sind Nachfahren des Elements mit der Rolle dialog.
- Der Container hat aria-modal mit dem Wert true.
- Der Dialog hat entweder ein aria-labelledby, das auf einen sichtbaren Dialogtitel verweist, oder eine Beschriftung über aria-label.
- Optional: aria-describedby am Element mit der Rolle dialog verweist auf das Element oder die Elemente, die den Hauptzweck oder die Botschaft des Dialogs beschreiben. Screenreader können diese Beschreibung dann zusammen mit dem Titel und dem anfangs fokussierten Element ansagen. Das ist typischerweise nur hilfreich, wenn die Beschreibung einfach und ohne Strukturinformationen verständlich ist; es ist ratsam, darauf zu verzichten, wenn der Inhalt semantische Strukturen wie Listen, Tabellen oder mehrere Absätze enthält, die am Stück vorgelesen schwer zu verstehen wären.
aria-modal oder aria-hidden: die Vorsichtshinweise des W3C
Wer einen Dialog mit aria-modal="true" als modal kennzeichnet, kann Nutzer mancher assistiver Technologien daran hindern, Inhalte außerhalb des Dialogs wahrzunehmen. Ist ein Dialog als modal gekennzeichnet, verhält sich für andere Nutzer aber nicht modal, hat das für die Nutzer dieser assistiven Technologien gravierende negative Folgen. Der APG verlangt daher, einen Dialog nur dann als modal zu kennzeichnen, wenn beide Bedingungen erfüllt sind: Der Anwendungscode hindert alle Nutzer daran, in irgendeiner Weise mit dem Inhalt außerhalb zu interagieren, und die visuelle Gestaltung verdeckt diesen Inhalt.
Die mit ARIA 1.1 eingeführte Eigenschaft aria-modal ersetzt aria-hidden, um assistiven Technologien mitzuteilen, dass der Inhalt außerhalb eines Dialogs inert ist. In älteren Implementierungen, die dafür noch aria-hidden verwenden, sind zwei Punkte wichtig:
- aria-hidden ist auf jedem Element, das einen Teil der inerten Ebene enthält, auf true gesetzt;
- das Dialogelement ist kein Nachfahre eines Elements, bei dem aria-hidden auf true gesetzt ist.
Checkliste zum Testen Ihres barrierefreien modalen Dialogs
Um einen vorhandenen modalen Dialog zu prüfen, gehen Sie die Punkte des W3C-Musters einzeln durch, zuerst nur mit der Tastatur, dann mit einem Screenreader. Das W3C bietet außerdem zwei Referenzbeispiele: ein Beispiel für modale Dialoge mit mehreren Dialogebenen und wenig oder viel Inhalt sowie einen Datumsauswahl-Dialog mit einem Kalender-Grid.
- Liegt der Fokus beim Öffnen im Dialog, an einer zum Inhalt passenden Stelle?
- Laufen Tab und Umschalt + Tab im Kreis, ohne den Dialog je zu verlassen?
- Schließt Escape den Dialog?
- Kehrt der Fokus beim Schließen zum auslösenden Element zurück oder, falls das auslösende Element nicht mehr existiert, zu einem anderen logischen Element?
- Ist eine sichtbare Schließen-Schaltfläche Teil der Tab-Reihenfolge?
- Hat der Container role="dialog", aria-modal="true" und einen Namen über aria-labelledby oder aria-label?
- Ist der Inhalt außerhalb wirklich für alle inert und visuell verdeckt?
Häufige Fragen
Wie macht man einen modalen Dialog barrierefrei?
Laut W3C: Fokus beim Öffnen in den Dialog setzen, Tab und Umschalt + Tab innerhalb des Dialogs im Kreis laufen lassen, mit Escape schließen und beim Schließen den Fokus an das auslösende Element zurückgeben. Der Container trägt role="dialog", aria-modal="true" und einen zugänglichen Namen über aria-labelledby oder aria-label.
Welche ARIA-Rolle braucht ein modaler Dialog?
Die Rolle dialog am Container. Für einen Dialog, der die Aufmerksamkeit des Nutzers auf eine kurze, wichtige Meldung lenkt, sieht das W3C die Rolle alertdialog vor, beschrieben im Alert Dialog Pattern.
Wohin gehört der Fokus beim Öffnen eines modalen Dialogs?
In der Regel auf das erste fokussierbare Element. Ist der Inhalt strukturiert oder lang, ist es ratsam, ein statisches Element mit tabindex="-1" zu fokussieren, am Anfang des Inhalts oder oben im Dialog (Titel, erster Absatz). Vor einer schwer umkehrbaren Aktion kann es ratsam sein, die am wenigsten destruktive Aktion zu fokussieren.
Muss die Escape-Taste einen modalen Dialog schließen?
Ja, laut W3C-Muster für modale Dialoge schließt Escape den Dialog. Außerdem wird dringend empfohlen, eine sichtbare Schließen-Schaltfläche in die Tab-Reihenfolge aufzunehmen.
aria-modal oder aria-hidden verwenden?
aria-modal, eingeführt mit ARIA 1.1, ersetzt aria-hidden, um zu signalisieren, dass der Inhalt außerhalb inert ist. Kennzeichnen Sie einen Dialog nur dann als modal, wenn der Code alle Nutzer an der Interaktion mit dem Inhalt außerhalb hindert und die Gestaltung ihn verdeckt. In älteren Implementierungen mit aria-hidden setzen Sie aria-hidden="true" auf jedes Element der inerten Ebene und stellen sicher, dass der Dialog kein Nachfahre eines Elements mit aria-hidden="true" ist.
Wohin geht der Fokus, wenn ein modaler Dialog geschlossen wird?
Zu dem Element, das ihn geöffnet hat. Existiert es nicht mehr, geht der Fokus auf ein anderes Element, das einen logischen Arbeitsablauf ermöglicht. Wenn der Ablauf es rechtfertigt (sofortiges erneutes Öffnen sehr unwahrscheinlich, Aufgabe direkt mit dem nächsten Schritt verknüpft), kann auch ein anderes Element sinnvoller sein.
Weiterlesen bei Conformly
Quellen
Dieser Artikel stützt sich auf die am Seitenende genannten offiziellen Quellen.