HTMLDialogElement: closedBy-Eigenschaft

Wert

Ein String; mögliche Werte sind:

any

Der Dialog kann durch eine leichte Abweisen-Benutzeraktion, eine plattformspezifische Benutzeraktion oder einen vom Entwickler festgelegten Mechanismus geschlossen werden.

closerequest

Der Dialog kann durch eine plattformspezifische Benutzeraktion oder einen vom Entwickler festgelegten Mechanismus geschlossen werden.

none

Der Dialog kann nur durch einen vom Entwickler festgelegten Mechanismus geschlossen werden.

Standardverhalten

Wenn das closedby-Attribut fehlt oder ungültig ist, wird auf den Auto-Zustand zurückgefallen. Im Auto-Zustand:

• wenn das <dialog> mit showModal() geöffnet wird, verhält es sich so, als ob: closedby="closerequest"
• wenn das <dialog> auf andere Weise geöffnet wird, verhält es sich so, als ob: closedby="none"

Beispiele

Grundlegende Nutzung von closedBy

<dialog closedby="any">
  <p>
    Closable using the <kbd>Esc</kbd> key, or by clicking outside the dialog
    ("light dismiss").
  </p>
</dialog>

<pre id="log"></pre>
<button id="open">Open modal</button>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}
const button = document.getElementById("open");
button.addEventListener("click", () => {
  const dialog = document.querySelector("dialog");
  dialog.showModal();
});

const dialog = document.querySelector("dialog");
log(`closedBy: ${dialog.closedBy}`);

Ergebnis

Spezifikationen

Browser-Kompatibilität

Siehe auch

• HTML <dialog>-Element