CKTIS / HTML
oncancel — das cancel-Ereignis behandeln
Das Attribut oncancel enthält Code, der ausgeführt wird, wenn ein cancel-Ereignis empfangen wird. Bei einem dialog-Element kannst du auf eine Schließanforderung reagieren und das Schließen verhindern, sofern das Ereignis abbrechbar ist.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel ist ein Ereignisbehandlungsattribut für cancel, das bei allen HTML-Elementen verfügbar ist. Sein Wert ist JavaScript-Code, kein Ereignisname und kein boolescher Wert. Das JavaScript-Gegenstück ist die Eigenschaft element.oncancel, der eine Funktion oder null zugewiesen werden kann.
Eine typische Verwendung ist das Element dialog: cancel signalisiert eine Schließanforderung, nicht ein bereits erfolgtes Schließen. Die Methode requestClose() löst zuerst cancel aus; die Methode close() überspringt diesen Schritt. Das Ereignis close meldet dagegen das Schließen.
Wenn event.cancelable den Wert true hat, verhindert event.preventDefault() das standardmäßige Schließen. Auch die Rückgabe von false aus einem oncancel-Handler bricht das Ereignis ab, sofern es abbrechbar ist. Gehe nicht davon aus, dass sich jede Schließanforderung blockieren lässt.
Das Beispiel öffnet einen nicht-modalen Dialog und ruft requestClose() auf. Das Attribut verhindert das Schließen, daher lautet das gespeicherte Ergebnis open: true. Das abschließende close() entfernt den Dialog aus der Ansicht, ohne cancel erneut auszulösen.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>oncancel</title>
<dialog id="demo" oncancel="event.preventDefault()">
<p>Dialog</p>
</dialog>
<pre id="result"></pre>
<script>
const demo = document.getElementById('demo');
const result = document.getElementById('result');
demo.show();
demo.requestClose();
result.textContent = `open: ${demo.open}`;
demo.close();
</script>Ergebnis
open: true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.