Web & Entwicklung

Wie man zugängliche Modal-Dialoge mit HTML, CSS und JavaScript erstellt

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

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.

Illustration of the article's main concept

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

Technical workflow illustration

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.

Offizielle und technische Referenzen