HTML/Elemente/dialog

Das dialog-Element öffnet ein Dialog-Fenster, das vom Benutzer bearbeitet werden muss. Die Steuerung erfolgt über JavaScript. 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.

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>

Beachten Sie:

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

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!
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 angezeigen.

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
• GitHub: Dialog-Polyfill des Google Chrome Teams