Kostenloser Scan

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:

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:

<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:

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:

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.

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.