CKTIS / HTML
oncancel — obrada događaja cancel
Atribut oncancel sadrži kod koji se izvršava pri primitku događaja cancel. Na elementu dialog omogućuje reakciju na zahtjev za zatvaranje i sprječavanje zatvaranja ako se događaj može otkazati.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel je atribut rukovatelja događajem cancel, dostupan na svim HTML elementima. Njegova je vrijednost JavaScript kod, a ne naziv događaja ili Booleova vrijednost. Njegov je JavaScript ekvivalent svojstvo element.oncancel, kojem se može dodijeliti funkcija ili null.
Uobičajena je primjena na elementu dialog: cancel označava zahtjev za zatvaranje, a ne već dovršeno zatvaranje. Metoda requestClose() najprije pokreće cancel; metoda close() preskače taj korak. Događaj close pak označava zatvaranje.
Kada je event.cancelable jednak true, event.preventDefault() sprječava zadano zatvaranje. Vraćanje vrijednosti false iz rukovatelja oncancel također otkazuje događaj ako se on može otkazati. Nemojte pretpostaviti da se svaki zahtjev za zatvaranje može blokirati.
Primjer otvara nemodalni dijaloški okvir i poziva requestClose(). Atribut sprječava zatvaranje pa je zabilježeni rezultat open: true. Završni close() uklanja dijaloški okvir iz prikaza bez ponovnog pokretanja događaja cancel.
Primjeri
<!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>Rezultat
open: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.