CKTIS / HTML
oncancel — de cancel-gebeurtenis afhandelen
Het oncancel-attribuut bevat code die wordt uitgevoerd wanneer een cancel-gebeurtenis wordt ontvangen. Bij een dialog-element kun je reageren op een sluitverzoek en, als de gebeurtenis annuleerbaar is, het sluiten voorkomen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel is een gebeurtenisafhandelingsattribuut voor cancel en is beschikbaar op alle HTML-elementen. De waarde is JavaScript-code, geen gebeurtenisnaam of Booleaanse waarde. Het JavaScript-equivalent is de eigenschap element.oncancel, waaraan een functie of null kan worden toegewezen.
Een gebruikelijke toepassing is het element dialog: cancel geeft een sluitverzoek aan, niet een al voltooide sluiting. De methode requestClose() activeert eerst cancel; de methode close() slaat die stap over. De gebeurtenis close meldt juist dat het element wordt gesloten.
Als event.cancelable de waarde true heeft, voorkomt event.preventDefault() het standaard sluiten. Ook het retourneren van false vanuit een oncancel-handler annuleert de gebeurtenis wanneer die annuleerbaar is. Ga er niet van uit dat elk sluitverzoek kan worden geblokkeerd.
Het voorbeeld opent een niet-modaal dialoogvenster en roept requestClose() aan. Het attribuut voorkomt het sluiten, dus het vastgelegde resultaat is open: true. De laatste close() haalt het dialoogvenster uit beeld zonder cancel opnieuw te activeren.
Voorbeelden
<!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>Resultaat
open: true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.