WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

aria-modal — Semantik modaler Dialoge

Das Attribut aria-modal informiert assistive Technologien darüber, ob ein angezeigtes Element modal ist, also die Interaktion auf seinen Inhalt beschränkt. Es blockiert den Hintergrund nicht und verwaltet den Fokus nicht selbst: Die Angabe muss dem tatsächlichen Verhalten der Oberfläche entsprechen.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

aria-modal="true" | aria-modal="false"

aria-modal ist eine WAI-ARIA-Eigenschaft in HTML, die angibt, ob ein angezeigtes Element modal ist. Der Wert true kennzeichnet Modalität; false ist der Standardwert. Diese Eigenschaft verwendet die Textwerte true und false und folgt nicht der Syntax boolescher HTML-Attribute: Schreibe den Attributnamen nicht ohne Wert. Sie wird für die Rollen dialog und alertdialog unterstützt, nicht global für beliebige Elemente.

aria-modal="true" vermittelt assistiven Technologien die Semantik; diese können die Navigation auf den Inhalt des Dialogs beschränken. Das Attribut öffnet keinen Dialog, blockiert keine Klicks im Hintergrund und verschiebt oder hält den Fokus nicht fest. Setze es nur, wenn die Oberfläche tatsächlich verhindert, dass alle Nutzerinnen und Nutzer mit Inhalten außerhalb des Dialogs interagieren, und der Hintergrund visuell abgedunkelt oder verdeckt ist.

Verschiebe beim Öffnen den Fokus in den Dialog und halte die Sequenz von Tab und Shift+Tab darin. Stelle eine Schaltfläche zum Schließen im Dialog bereit und unterstütze Escape; stelle beim Schließen den Fokus üblicherweise auf das auslösende Element zurück. Gib dem Dialog einen zugänglichen Namen, zum Beispiel über aria-labelledby, das auf seine sichtbare Überschrift verweist. Alle Bedienelemente, die für die Verwendung des Dialogs nötig sind, müssen seine Nachfahren sein.

Das Beispiel verwendet einen nativen Dialog, der mit showModal() geöffnet wird, statt das modale Verhalten manuell nachzubilden. In diesem Fall ist aria-modal="true" überflüssig, weil die native Modalität assistiven Technologien bereits mitgeteilt wird; die Angabe bleibt enthalten, um die Syntax zu zeigen. Allein das Attribut zu einem gewöhnlichen Container hinzuzufügen, bewirkt dieses Verhalten nicht. Prüfe die Bedienung per Tastatur und die Semantik im Barrierefreiheitsbaum getrennt voneinander.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Ergebnis

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen