HTMLDialogElement: closedBy-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Die closedBy-Eigenschaft des HTMLDialogElement-Interfaces gibt die Arten von Benutzeraktionen an, mit denen das zugehörige <dialog>-Element geschlossen werden kann. Sie setzt oder gibt den Wert des closedby-Attributs des Dialogs zurück.

Wert

Ein String; mögliche Werte sind:

any: Der Dialog kann durch eine leichte Löschaktion des Benutzers, eine plattformabhängige Benutzeraktion oder einen entwicklerspezifischen Mechanismus geschlossen werden.
closerequest: Der Dialog kann durch eine plattformabhängige Benutzeraktion oder einen entwicklerspezifischen Mechanismus geschlossen werden.
none: Der Dialog kann nur durch einen entwicklerspezifischen 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

Spezifikation
HTML # dom-dialog-closedby

Browser-Kompatibilität

Siehe auch

HTML <dialog>-Element

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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