HTMLDialogElement: closedBy-Eigenschaft

Eingeschränkt verfügbar

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

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