[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/HTMLDialogElement/returnValue [Back]  [Original]

HTMLDialogElement: returnValue-Eigenschaft - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen bersetzt, und kann Fehler enthalten. Erfahre mehr ber dieses Experiment.

View in English Always switch to English

HTMLDialogElement: returnValue-Eigenschaft

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Mrz 2022 browserbergreifend verfgbar.

Die returnValue-Eigenschaft des HTMLDialogElement-Interfaces ist ein String, der den Rckgabewert fr ein <dialog>-Element reprsentiert, wenn es geschlossen wird. Sie knnen den Wert direkt setzen (dialog.returnValue = "result") oder den Wert als String-Argument an close() oder requestClose() bergeben.

In diesem Artikel

Wert

Ein String, der den returnValue des Dialogs reprsentiert. Standardmig ist dies ein leerer String ("").

Beispiele

berprfen des Rckgabewerts

Das folgende Beispiel zeigt eine Schaltflche, um einen Dialog zu ffnen. Der Dialog fragt den Benutzer, ob er einer Aufforderung zu den Nutzungsbedingungen zustimmen mchte.

Der Dialog enthlt die Schaltflchen "Akzeptieren" oder "Ablehnen": Wenn der Benutzer auf eine der Schaltflchen klickt, schliet der Klick-Handler der Schaltflche den Dialog und bergibt seine Wahl an die close()-Funktion. Dies weist die Wahl der returnValue-Eigenschaft des Dialogs zu.

Im close-Ereignishandler des Dialogs wird der Status-Text der Hauptseite aktualisiert, um den returnValue zu protokollieren.

Wenn der Benutzer den Dialog ohne Klicken auf eine Schaltflche schliet (z. B. durch Drcken der Esc-Taste), wird kein Rckgabewert gesetzt.

HTML

html
<dialog id="dialog">
  <p>Do you agree to the Terms of Service (link)?</p>
  <button id="decline" value="declined">Decline</button>
  <button id="accept" value="accepted">Accept</button>
</dialog>
<button id="open">Open dialog</button>

JavaScript

js
const dialog = document.getElementById("dialog");
const openButton = document.getElementById("open");
const declineButton = document.getElementById("decline");
const acceptButton = document.getElementById("accept");

openButton.addEventListener("click", () => {
  // Reset the return value on each open
  dialog.returnValue = "";
  updateReturnValue();
  // Show the dialog
  dialog.showModal();
});

function closeDialog(event) {
  const button = event.target;
  dialog.close(button.value);
}

function updateReturnValue() {
  log(`Return value: "${dialog.returnValue}"`);
}

declineButton.addEventListener("click", closeDialog);
acceptButton.addEventListener("click", closeDialog);

dialog.addEventListener("close", updateReturnValue);

Ergebnis

Klicken Sie auf "Dialog ffnen", whlen Sie dann die Schaltflchen "Akzeptieren" oder "Ablehnen" im Dialog oder schlieen Sie den Dialog, indem Sie die Esc-Taste drcken. Beobachten Sie die verschiedenen Statusaktualisierungen.

Spezifikationen

Spezifikation
HTML
# dom-dialog-returnvalue-dev

Browser-Kompatibilitt

Siehe auch


Web Proxy Viewer  |  New URL  |  Original Page