CKTIS / HTML
oncancel — obravnavanje dogodka cancel
Atribut oncancel vsebuje kodo, ki se izvede ob prejemu dogodka cancel. Pri elementu dialog omogoča odziv na zahtevo za zapiranje in preprečitev zapiranja, če je dogodek mogoče preklicati.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel je atribut za obravnavo dogodka cancel, ki je na voljo pri vseh elementih HTML. Njegova vrednost je koda JavaScript, ne ime dogodka ali logična vrednost. Ustrezna lastnost v JavaScriptu je element.oncancel, ki ji lahko dodelite funkcijo ali null.
Pogosta uporaba je pri elementu dialog: cancel označuje zahtevo za zapiranje, ne že izvedenega zaprtja. Metoda requestClose() najprej sproži cancel; metoda close() ta korak preskoči. Dogodek close pa sporoča, da se je element zaprl.
Če je vrednost event.cancelable enaka true, event.preventDefault() prepreči privzeto zapiranje. Tudi vrnitev vrednosti false iz obravnavalnika oncancel prekliče dogodek, kadar ga je mogoče preklicati. Ne predpostavljajte, da je mogoče blokirati vsako zahtevo za zapiranje.
Primer odpre nemodalno pogovorno okno in pokliče requestClose(). Atribut prepreči zapiranje, zato je zabeleženi rezultat open: true. Končni klic close() odstrani pogovorno okno iz prikaza, ne da bi znova sprožil cancel.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.