HTMLDialogElement: close() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

Die close() Methode der HTMLDialogElement Schnittstelle schließt das

. Ein optionaler String kann als Argument übergeben werden, um den returnValue des Dialogs zu aktualisieren.

Syntax

js
close()
close(returnValue)

Parameter

returnValue Optional

Ein String, der einen aktualisierten Wert für den HTMLDialogElement.returnValue des Dialogs darstellt.

Rückgabewert

Keiner (undefined).

Beispiele

Das folgende Beispiel zeigt einen einfachen Button, der beim Anklicken ein

öffnet, das ein Formular über die showModal() Methode enthält. Danach können Sie auf den X Button klicken, um den Dialog zu schließen (über die HTMLDialogElement.close() Methode), oder das Formular über den Senden-Button abschicken.

html

Wenn der "X" Button den type="submit" hätte, würde der Dialog geschlossen werden, ohne dass JavaScript erforderlich ist. Eine Formularübermittlung schließt das

, in dem es eingebettet ist, wenn die method des Formulars dialog ist, sodass kein "close" Button erforderlich ist.

Ergebnis

Spezifikationen

Specification
HTML
# dom-dialog-close-dev

Browser-Kompatibilität

Siehe auch

  • Das HTML-Element, das diese Schnittstelle implementiert: .