Wie man zugängliche Modal-Dialoge mit HTML, CSS und JavaScript erstellt
Erstellen Sie zugängliche Modal-Dialoge mit dem nativen HTML-Dialog-Element. Lernen Sie, wie Sie Popups öffnen und schließen, die Tastaturfokussierung verwalten, Hintergründe gestalten und Bestätigungsdialoge ohne JavaScript-Bibliothek erstellen.
Wie man zugängliche Modale Dialoge mit HTML, CSS und JavaScript erstellt
Ein Besucher klickt auf eine Schaltfläche auf Ihrer Website. Ein Popup erscheint mit einem Formular, einer Bestätigungsnachricht oder zusätzlichen Informationen.
Die Erstellung des visuellen Popups ist einfach. Es ist eine andere Angelegenheit, es richtig mit Tastatur, Screenreader und mobiler Browser funktionieren zu lassen.
Viele benutzerdefinierte Modaldarstellungen beruhen auf großen Mengen JavaScript zur Verwaltung von Fokus, Blockierung der Interaktion mit der Seite und Behandlung der Escape-Taste.
Modernes HTML bietet einen einfacheren Ansatz: das native <dialog> Element.
Es bietet viel Verhalten, das man von einem modalen Dialog erwartet, direkt im Browser. Sie können ein funktionales Popup mit einer kleinen Menge HTML, CSS und JavaScript erstellen, ohne Framework oder Plugin zu installieren.
In diesem Tutorial bauen wir einen wiederverwendbaren Dialog, stylen ihn, fügen einen Bestätigungsdialog hinzu und untersuchen die für echte Websites relevanten Barrierefreiheitsdetails.
1. Was macht einen modalen Dialog anders als ein reguläres Popup?
Ein modaler Dialog erfordert den Besucher vorübergehend, mit einem bestimmten Teil der Oberfläche zu interagieren, bevor er zur Hauptseite zurückkehrt.
Typische Beispiele sind:
- Bestätigen, dass ein Element gelöscht wird.
- Anzeigen eines Kontaktformulars.
- Nach Bestätigung fragen, bevor man eine Seite verlässt.
- Zusätzliche Produkinformationen anzeigen.
- Eine Anwendungs-Einstellung bearbeiten.
Ein richtig implementierter Dialog sollte seine Funktion klar machen, einen offensichtlichen Weg zum Schließen anbieten und die Tastaturverwaltung angemessen handhaben.
Das native <dialog> Element unterstützt sowohl modale als auch nichtmodale Verhalten.
| Methode | Verhalten |
|---|---|
showModal() |
Opens a modal and makes the rest of the document inert |
show() |
Opens a non-modal dialog |
close() |
Closes the dialog |
method="dialog" |
Allows a form button to close the dialog |
Das modale Verhalten umfasst Fokusverwaltung und Tastaturinteraktion, die der Browser bereitstellt.
2. Erstellen Sie Ihren ersten HTML-Dialog
Beginnen wir mit einem einfachen Beispiel: einer Schaltfläche, die einen Dialog mit Titel, etwas Text und einem Schließen-Button öffnet.
<button type="button" id="openDialog">
View delivery information
</button>
<dialog id="deliveryDialog"
aria-labelledby="deliveryTitle">
<h2 id="deliveryTitle">
Delivery information
</h2>
<p>
Orders are prepared within two business days.
You will receive a tracking link by email.
</p>
<form method="dialog">
<button type="submit" autofocus>
Close
</button>
</form>
</dialog>
<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');
openButton.addEventListener('click', () => {
dialog.showModal();
});
</script>
Das reicht aus, um einen funktionierenden modalen Dialog zu erstellen.
Wenn der Besucher auf die Schaltfläche klickt, öffnet showModal() den Dialog über dem Seiteninhalt.
Der Browser behandelt mehrere wichtige Verhaltensweisen automatisch:
- Der Dialog tritt in die Top-Layer-Ebene ein, über dem normalen Seiteninhalt.
- Der Rest des Dokuments wird inert.
- Der Tastaturfokus verschiebt sich in den Dialog.
- Die Escape-Taste schließt normalerweise.
- Der Fokus kehrt normalerweise zum öffnenden Button zurück, wenn der Dialog geschlossen wird.
Der Schließen-Button verwendet method="dialog", sodass er keinen JavaScript-Event-Handler benötigt.
3. Gestalten Sie den Dialog mit CSS
Der Standarddialog funktioniert, aber seine Optik ist einfach.
Wir können ihm abgerundete Ecken, bequeme Abstände, eine responsive Breite und einen Hintergrund geben.
dialog {
width: min(90vw, 520px);
max-height: 85vh;
box-sizing: border-box;
padding: 2rem;
border: 0;
border-radius: 14px;
background: #fff;
color: #20242b;
box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
overflow: auto;
}
dialog::backdrop {
background: rgba(15, 23, 42, .65);
backdrop-filter: blur(3px);
}
dialog h2 {
margin-top: 0;
font-size: 1.5rem;
}
dialog p {
line-height: 1.6;
}
dialog button {
padding: .75rem 1.25rem;
border: 0;
border-radius: 8px;
background: #2458d3;
color: #fff;
font: inherit;
cursor: pointer;
}
dialog button:focus-visible {
outline: 3px solid #f59e0b;
outline-offset: 3px;
}
Das ::backdrop Pseudoelement gestaltet die Ebene hinter einem modalen Dialog.
Es erscheint nur, wenn der Dialog modally angezeigt wird, z. B. durch showModal().
Ein durch show() geöffneter Dialog erhält nicht automatisch dasselbe modale Hintergrundverhalten.
Warum Top-Layer verwenden?
Traditionelle benutzerdefinierte Popups beruhen oft auf zunehmend größeren z-index Werten.
Ein durch showModal() geöffneter modaler Dialog tritt in die Top-Layer-Ebene des Browsers ein, was viele Stacking-Context-Probleme vermeidet.
Dies ist besonders hilfreich auf Websites mit festen Headern, schwebenden Widgets und komplexen Page-Buildern.
4. Verstehen Sie die Tastaturnutzbarkeit
Ein Dialog muss ohne Maus funktionieren.
Stellen Sie sich vor, ein Besucher navigiert über die Tab-Taste durch Ihre Website. Wenn ein Dialog geöffnet wird, sollte er mit seinen Steuerelementen interagieren können, ohne versehentlich in die dahinterliegende Seite zu wechseln.
Der native modale Dialog hilft bei diesem Verhalten.
Das W3C beschreibt das HTML-Dialog-Element als Technik zur Erstellung zugänglicher modaler Dialoge, einschließlich Fokuskapselung und Rückgabe des Fokus, wenn der Dialog geschlossen wird.
Geben Sie dem Dialog einen zugänglichen Namen
Verwenden Sie eine sichtbare Überschrift und verweisen Sie darauf mit aria-labelledby:
<dialog aria-labelledby="settingsTitle">
<h2 id="settingsTitle">Account settings</h2>
...
</dialog>
Dies gibt Assistivtechnologien einen aussagekräftigen Namen für den Dialog.
Wählen Sie den Anfangsfokus sorgfältig
Das autofocus Attribut kann das Steuerelement identifizieren, das Fokus erhalten soll, wenn der Dialog geöffnet wird.
Für einen Informationsdialog kann die Fokussierung auf den Schließen-Button angemessen sein.

Für ein Formular kann es sinnvoller sein, das erste Eingabefeld zu fokussieren.
Für eine destruktive Bestätigung ist es oft vorzuziehen, die sicherere Aktion, wie Abbrechen, zu fokussieren.
Vermeiden Sie es, tabindex direkt auf dem <dialog> Element zu platzieren; die HTML-Spezifikation verbietet dieses Attribut auf dem Element selbst.
Stellen Sie immer einen sichtbaren Schließen-Button bereit
Auch wenn Escape normalerweise einen modalen Dialog schließt, bleibt eine sichtbare Schaltfläche zum Schließen wesentlich.
Mobile-Besucher haben möglicherweise keine physische Tastatur, und einige Benutzer wissen nicht, dass Escape ein Popup schließen kann.
5. Erstellen Sie einen Bestätigungsdialog mit zwei Schaltflächen
Jetzt bauen wir ein nützlicheres Beispiel: Bestätigen, dass ein gespeichertes Element gelöscht wird.
Der Besucher sollte in der Lage sein, Abbrechen oder Löschen auszuwählen.
HTML bietet über method="dialog" und die returnValue Eigenschaft des Dialogs einen bequemen Mechanismus.
<button type="button" id="deleteItem">
Delete item
</button>
<dialog id="confirmDialog"
aria-labelledby="confirmTitle">
<h2 id="confirmTitle">
Delete this item?
</h2>
<p>
This action cannot be undone.
</p>
<form method="dialog">
<button value="cancel" autofocus>
Cancel
</button>
<button value="confirm">
Delete
</button>
</form>
</dialog>
<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');
deleteButton.addEventListener('click', () => {
confirmDialog.returnValue = 'cancel';
confirmDialog.showModal();
});
confirmDialog.addEventListener('close', () => {
if (confirmDialog.returnValue === 'confirm') {
// Call your application deletion logic here.
console.log('Deletion confirmed');
}
});
</script>
Der wichtige Detail ist, dass das Klicken auf eine Schaltfläche innerhalb eines method="dialog" Formulars den Dialog schließt und dessen returnValue festlegt.
Unser Code prüft, ob der Benutzer confirm ausgewählt hat.
Das Zurücksetzen des Werts vor dem Öffnen verhindert, dass eine frühere Bestätigung fälschlicherweise als eine neue angesehen wird, wenn der Benutzer den Dialog mit Escape abweist.
Das Beispiel löscht absichtlich nichts. In einer echten Anwendung würde die bestätigte Aktion Ihre eigene PHP-Endpunkt- oder Anwendungs-Controller aufrufen, mit den notwendigen Autorisierungs- und CSRF-Schutzmaßnahmen.
6. Testen Sie den Bestätigungsablauf
Eine nützliche Demonstration ist eine Liste gespeicherter Elemente, jedes mit einer Löschschaltfläche. Beim Klicken auf Löschen sollte ein Bestätigungsdialog geöffnet werden. Abbrechen sollte das Element unverändert lassen; Bestätigen sollte nur das ausgewählte Element entfernen.
Dies veranschaulicht den Bestätigungsablauf, ohne echte Website-Daten zu ändern.
7. Fügen Sie ein Kontaktformular in einen Dialog ein
Ein Kontaktformular ist ein weiteres häufiges Anwendungsfall.
Aber es gibt einen wichtigen Unterschied zwischen dem Schließen eines Dialogs und dem Senden von Daten an einen Server.
Ein Formular mit method="dialog" schließt das Popup. Es sendet keine konventionelle HTTP-Anfrage an Ihre PHP-Backend.
Für ein echtes Kontaktformular verwenden Sie eine normale Formularübermittlung oder eine AJAX-Anfrage.
Zum Beispiel:
<dialog id="contactDialog"
aria-labelledby="contactTitle">
<h2 id="contactTitle">
Contact us
</h2>
<form action="/contact-handler.php" method="post">
<label for="contactEmail">
Your email
</label>
<input
type="email"
id="contactEmail"
name="email"
required
autocomplete="email"
autofocus
>
<label for="contactMessage">
Your message
</label>
<textarea
id="contactMessage"
name="message"
required
></textarea>
<button type="submit">
Send message
</button>
<button type="button" id="closeContact">
Cancel
</button>
</form>
</dialog>
Die Schaltfläche Senden übermittelt das Formular normalerweise.
Die Schaltfläche Abbrechen sollte den Dialog ohne Übermittlung schließen:
document.getElementById('closeContact')
.addEventListener('click', () => {
document.getElementById('contactDialog').close();
});
Ihr PHP-Handler muss weiterhin die übermittelten Daten validieren, Anti-Spam-Schutz implementieren und eine aussagekräftige Erfolgs- oder Fehlermeldung zurückgeben.
Ein modaler Dialog verbessert die Oberfläche; er ersetzt nicht die serverseitige Formularsicherheit.
8. Können Benutzer den Dialog durch Klicken außerhalb schließen?
Viele Websites ermöglichen es Besuchern, ein Popup durch Klicken auf den Hintergrund zu schließen.
Dieses Verhalten wird oft als light dismiss bezeichnet.
Modernes HTML enthält das closedby Attribut, mit dem festgelegt werden kann, ob ein Dialog durch außerhalbinteraktion, Plattform-Schließanfragen oder explizite Kontrollen geschlossen werden darf.
Zum Beispiel:
<dialog id="infoDialog" closedby="any">
<h2>More information</h2>
<p>Additional details appear here.</p>
<form method="dialog">
<button>Close</button>
</form>
</dialog>
Der closedby="any" Wert ermöglicht das Light-Dismiss-Verhalten in Browsern, die es unterstützen.
Allerdings sollte die Unterstützung neuer Dialogfunktionen gegen Ihre Ziel-Browser geprüft werden. Die grundlegenden showModal() und close() APIs sind allgemeiner etabliert.
Bei kritischen Bestätigungsdialogen kann versehentliches Äußeres Schließen unerwünscht sein.
In allen Fällen sollten Sie eine sichtbare Schließ- oder Abbrechen-Steuerung beibehalten.
9. Vermeiden Sie diese häufigen Implementierungsfehler

Einen Dialog durch Hinzufügen des open Attributs zu öffnen
Dieser Code:
dialog.setAttribute('open', '');
stellt nicht das gleiche Verhalten bereit wie:
dialog.showModal();
Das open Attribut zeigt den Dialog nicht modally an. Es macht nicht automatisch den Rest des Dokuments inert.
Verwenden Sie showModal(), wenn Sie einen echten Dialog benötigen.
Das Entfernen des open-Attributs zum Schließen eines Dialogs
Vermeiden Sie es, das open Attribut manuell von einem aktiven Dialog zu entfernen.
Verwenden Sie:
dialog.close();
Dies folgt dem beabsichtigten Lebenszyklus und stellt das geeignete Schließverhalten sicher.
Verwenden Sie anstelle eines Buttons einen Link
Eine Steuerung, die eine Schnittstellenaktion öffnet, sollte im Allgemeinen eine Schaltfläche sein:
<button type="button">Open settings</button>
Verwenden Sie Links für die Navigation zu einer anderen Ressource.
Das Vergessen der Sichtbarkeit des Fokus
Benutzer, die mit der Tastatur navigieren, benötigen eine sichtbare Kennzeichnung, welches Steuerelement aktiv ist.
Halten Sie einen klaren :focus-visible Stil ein, anstatt Browser-Fokuszurlinien ohne Ersatz zu entfernen.
Das Platzieren des Dialogs in einem versteckten Container
Wenn ein übergeordneter Container versteckt ist oder ein CMS das umgebende Markup dynamisch ersetzt, kann sich der Dialog anders verhalten.
Für Page-Builder-Integrationen bevorzugen Sie einen stabilen Container und stellen Sie sicher, dass das JavaScript nach dem Einfügen des Dialogs in das Dokument ausgeführt wird.
10. Integrieren Sie einen Dialog in WordPress oder Joomla
Sie müssen keine Erweiterung erstellen, um das native Dialog-Element zu verwenden.
Für eine einfache Website besteht die Integration aus drei Teilen:
| Teil | Ort |
|---|---|
| HTML-Markup | Custom-HTML-Block, Modul, Template oder Page-Builder-Element |
| CSS | Theme- oder Template-Custom-CSS |
| JavaScript | Theme/Template-Custom-JavaScript oder eine unterstützte Code-Einsetzungsfunktion |
WordPress
In WordPress können Sie das HTML in einem Custom-HTML-Block platzieren, sofern Ihre Konten- und Editor-Konfiguration die notwendigen Markup zulässt.
Fügen Sie das Styling über den unterstützten Custom-CSS-Mechanismus Ihres Themes hinzu.
Für das JavaScript verwenden Sie einen theme-unterstützten Skriptbereich, ein Child Theme oder eine seriöse Code-Einsetzungserweiterung, die JavaScript richtig handhabt.
Einige Editoren und Sicherheitskonfigurationen filtern <script> Elemente. Vermeiden Sie zu unterstellen, dass JavaScript, das direkt in einen Inhaltsblock eingefügt wird, ausgeführt wird.
Joomla
In Joomla kann ein Custom-Modul oder ein Editor, der geeignetes HTML-Markup zulässt, den Dialog enthalten.
Fügen Sie das CSS zu der Custom-Stylesheet Ihres Templates hinzu, z. B. user.css in einer Cassiopeia-basierten Website.
Platzieren Sie JavaScript an der unterstützten Custom-Skript-Position Ihres Templates oder über eine geeignete Erweiterung.
Abhängig vom konfigurierten Editor und den Textfiltern entfernt Joomla möglicherweise bestimmte Elemente oder Attribute, wenn Inhalte gespeichert werden.
Wenn Ihr Markup verschwindet, prüfen Sie den Editor und die Filterkonfiguration, anstatt immer wieder denselben Code einzufügen.
Page-Builder
Dasselbe Prinzip gilt für visuelle Page-Builder: nutzen Sie deren Fähigkeiten zur Integration von HTML, CSS und JavaScript.
Für dynamisch geladene Inhalte initialisieren Sie Event-Listener erst, nachdem die relevanten Elemente existieren.
Wenn eine Seite mehrere Dialoge enthält, weisen Sie jedem eine eindeutige ID zu.
11. Testen Sie Ihren Dialog, bevor Sie veröffentlichen
Ein Dialog, der auf dem Desktop korrekt aussieht, kann trotzdem Usability-Probleme haben.
Testen Sie ihn mit Maus, Tastatur und mobiler Gerät.
| Test | Erwartetes Ergebnis |
|---|---|
| Klicken auf öffnende Schaltfläche | Dialog erscheint |
| Drücken von Tab | Fokus bleibt innerhalb der Dialog-Steuerelemente |
| Drücken von Shift + Tab | Reverse-Tastaturnavigation funktioniert |
| Drücken von Escape | Dialog schließt, wenn erlaubt |
| Klicken auf Schließen oder Abbrechen | Dialog schließt |
| Dialog schließen | Fokus kehrt entsprechend zurück |
| Auf Mobile öffnen | Inhalt bleibt lesbar und scrollbar |
| Ungültiges Formular senden | Validierungsfeedback ist sichtbar |
| Gültiges Formular senden | Anwendung behandelt die Daten korrekt |
| Screenreader verwenden | Dialog hat einen verständlichen Namen |
Die WCAG-Technik H102 des W3C bietet nützliche Anleitung zur Validierung des nativen Dialogverhaltens.
12. Wann sollten Sie einen Dialog statt eines Plugins verwenden?
Ein natives Dialog eignet sich besonders für kleine, fokussierte Interaktionen: Bestätigungen, Informationspanels und einfache Formulare.
Für komplexere Anforderungen, wie mehrstufige Assistenten, fortschrittliche Galerien oder Dialoge, tief in einen CMS-Workflow integriert, kann eine dedizierte Komponente oder Erweiterung immer noch die wartungsfähigere Option sein.
Der Vorteil des nativen Ansatzes ist, dass er eine solide, browserunterstützte Grundlage bietet, ohne eine weitere JavaScript-Abhängigkeit einzuführen.
Es reduziert außerdem die Menge an benutzerdefinierter Fokus- und Tastaturverwaltung, die Sie selbst implementieren müssen.
Fazit: beginnen Sie mit den eingebauten Fähigkeiten des Browsers
Ein modaler Dialog muss nicht eine große JavaScript-Bibliothek erfordern.
Das native HTML-<dialog> Element bietet eine effektive Grundlage für zugängliche Popups, Bestätigungsnachrichten und Formulare.
Mit showModal(), close(), method="dialog" und einigen CSS-Regeln können Sie eine Oberfläche erstellen, die in modernen Browsern funktioniert und von den eingebauten Fokus- und Tastaturverhalten profitiert.
Für WordPress, Joomla und benutzerdefinierte PHP-Websites kann dies eine effiziente Alternative zum Installieren eines weiteren Plugins für eine relativ einfache Interaktion sein.
Der Schlüssel liegt darin, das native Verhalten korrekt zu verwenden, klare Kontrollen bereitzustellen und das Ergebnis mit realen Tastatur- und Mobilitätsinteraktionen zu testen.