WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

dialog — ein natives Dialogfenster

Das Element `dialog` stellt ein temporäres Fenster dar, in dem eine Aufgabe erledigt oder eine Information angezeigt wird. `show()` zeigt es nichtmodal an, während `showModal()` die Interaktion mit dem übrigen Dokument blockiert.

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

Syntax

<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);

dialog ist ein Fenster für eine kurze Interaktion mit der Anwendung und kein Ersatz für ein Menü oder einen Tooltip. Start- und End-Tag sind erforderlich. Ohne open wird es standardmäßig nicht angezeigt; open allein macht den Dialog nicht modal.

show() zeigt einen nichtmodalen Dialog an. showModal() platziert ihn in der obersten Ebene; der Rest des Dokuments wird inaktiv (inert). Das Element muss mit dem Dokument verbunden sein. Wird showModal() für einen bereits nichtmodal geöffneten Dialog aufgerufen, wird InvalidStateError ausgelöst.

Gib dem Dialog einen aussagekräftigen Namen, zum Beispiel mit aria-labelledby, und eine sichtbare Schaltfläche zum Schließen. Lege den anfänglichen Fokus mit autofocus auf einem geeigneten Steuerelement fest. Setze tabindex nicht auf dialog.

close(result) schließt den Dialog, speichert die angegebene Zeichenfolge in returnValue und löst ein close-Ereignis aus. requestClose(result) löst zuerst das abbrechbare Ereignis cancel aus; preventDefault() kann das Schließen verhindern. Entferne open nicht manuell, da dies den ordnungsgemäßen Ablauf beim Schließen umgeht. closedby steuert das automatische Schließen: any erlaubt auch Klicks außerhalb des Dialogs, closerequest erlaubt Schließanforderungen und none keines von beiden. Ohne dieses Attribut reagieren modale Dialoge auf Schließanforderungen, nichtmodale hingegen nicht.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Dialog example</title>
<button id="launch" type="button">Open</button>
<dialog id="box" aria-labelledby="heading">
  <h2 id="heading">Confirmation</h2>
  <p>Close this dialog to continue.</p>
  <button id="finish" type="button" autofocus>OK</button>
</dialog>
<p id="status" role="status">Ready</p>
<script>
  const box = document.getElementById('box');
  const status = document.getElementById('status');
  document.getElementById('launch').addEventListener('click', () => {
    box.returnValue = '';
    box.showModal();
  });
  document.getElementById('finish').addEventListener('click', () => {
    box.close('confirmed');
  });
  box.addEventListener('close', () => {
    status.textContent = box.returnValue === 'confirmed'
      ? 'Result: confirmed'
      : 'Result: dismissed';
  });
</script>
</html>

Ergebnis

Result: confirmed

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