HTML/Elemente/dialog

Das dialog-Element öffnet ein Dialog-Fenster, das vom Benutzer bearbeitet werden muss. Die Steuerung erfolgt über JavaScript, es gibt aber auch entsprechende Attribute, die native Methoden zur Verfügung stellen.

Syntax

Start-Tag: notwendig

End-Tag: notwendig

WAI‑ARIA‑Rolle

dialog

Elternelemente

Darf vorkommen in:

• Elementen mit flow content

erlaubte Inhalte

• flow content

Beispiel

<button type="button">Anmelden</button>

<dialog id="dialog">
   <h2>Anmeldung</h2>
   <form method="dialog">
      ...
     <button id="Anmeldung" value="anmelden">Anmelden</button>
     <button id="Abbruch" value="abbrechen">Abbrechen</button>
   </form>  
</dialog>

Im Beispiel-Snippet ist nur das HTML dargestellt. Ein Klick auf den Button würde vom (hier nicht gezeigten JavaScript) ausgewertet und löst die Öffnung der Dialog-Box aus.
Die Dialog-Box kann mit JavaScript wieder geschlossen werden, aber auch mit mehreren browsereigenen Methoden, die nicht extra programmiert werden müssen:

• Wenn der Dialog Buttons enthält, die beim Klicken den Dialog schließen sollen, empfiehlt es sich, in den Dialog ein form-Element mit method="dialog" einzusetzen.
• Mit showModal() geöffnete Dialoge reagieren standardmäßig auf die ESC-Taste und schließen sich.

Beachten Sie:

• Setzen Sie das open-Attribut niemals direkt. Benutzen Sie die showModal-Methode (bzw. die show-Methode) des HTMLDialogElement-Objekts oder das neue command-Attribut.
• Entfernen Sie das open-Attribut niemals direkt.

Attribute

Name	Inhalt	Standardwert	Bedeutung
Universalattribute
id	ID		identifiziert ein einziges Element innerhalb eines Dokuments
class	CDATA		ordnet ein Element einer oder mehreren Klassen zu.
accesskey	ID		Tastaturkürzel
contenteditable	CDATA		editierbarer Inhalt
contextmenu			definiert Kontextmenü
dir	ltr, rtl		definiert die Schreibrichtung innerhalb des Dokuments
draggable	ID		kann mit Drag & Drop gezogen werden
dropzone	CDATA		Aktion bei Ablegen
hidden			versteckter Inhalt
lang	NAME		legt eine den IANA-Sprachdefinitionen folgende Sprache des Elementinhalts fest [RFC1766]
spellcheck	ID		Rechtschreibprüfung Sollte auch für input type="password" deaktiviert werden.
style	CDATA		notiert direkt in einem Element- style sheet data
tabindex	NAME		zeigt an, ob dieses Element fokusiert werden kann, ob es mithilfe der Tastaturnavigation angesteuert werden kann und in welcher Reihenfolge navigiert wird.
title	CDATA		betitelt oder beschreibt ein Element.
tabindex	Zahl		Das tabindex-Attribut ist für Dialoge nicht zugelassen!
closedby	Aufzählung	Für modale Dialoge closerequest, für nichtmodale Dialoge none	Gibt an, auf welche Weise der Dialog geschlossen werden kann any Wie closerequest, zusätzlich kann der Dialog durch Klicken außerhalb des Dialogs geschlossen werden (light dismiss) closerequest Der Dialog kann durch einen Button eines Dialog-Formulars, durch die Esc-Taste oder durch JavaScript geschlossen werden none Der Dialog kann nur durch JavaScript geschlossen werden.
open	Boolesches Attribut		Zeigt an, dass der Dialog aktiv und eine Interaktion möglich ist. Browser sollen einen Dialog ohne open-Attribut dem Anwender nicht anzeigen. Manipulieren Sie das open-Attribut niemals selbst!

Attribut: Pflichtattribut
Attribut: optionales Attribut

Siehe auch

• Infobox/modale Dialogfenster
• JavaScript/Tutorials/Eigene modale Dialogfenster

Weblinks

Browserunterstützung
caniuse.com

• Spezifikation (WHATWG): dialog Element
• MDN: dialog