HTMLDialogElement: closedBy-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die closedBy-Eigenschaft des HTMLDialogElement-Interfaces gibt an, welche Benutzereingaben verwendet werden können, um das zugehörige <dialog>-Element zu schließen. Sie setzt oder gibt den Attributwert closedby des Dialogs zurück.

Wert

Ein String; mögliche Werte sind:

any: Der Dialog kann mit einer leichten Entlassungsaktion des Benutzers, einer plattform-spezifischen Benutzereingabe oder einem vom Entwickler angegebenen Mechanismus geschlossen werden.
closerequest: Der Dialog kann mit einer plattform-spezifischen Benutzereingabe oder einem vom Entwickler angegebenen Mechanismus geschlossen werden.
none: Der Dialog kann nur mit einem vom Entwickler angegebenen Mechanismus geschlossen werden.

Standardverhalten

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

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

Beispiele

Grundlegende Verwendung von `closedBy`

html

<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>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

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

Ergebnis

Spezifikationen

Specification
HTML # dom-dialog-closedby

Browser-Kompatibilität

Siehe auch

HTML <dialog>-Element

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden