CKTIS / HTML
oncancel — gestire l’evento cancel
L’attributo oncancel contiene il codice eseguito quando viene ricevuto un evento cancel. Su un elemento dialog consente di reagire a una richiesta di chiusura e, se l’evento è annullabile, di impedirne la chiusura.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel è un attributo gestore dell’evento cancel, disponibile su tutti gli elementi HTML. Il suo valore è codice JavaScript, non un nome di evento né un valore booleano. Il corrispondente JavaScript è la proprietà element.oncancel, a cui si può assegnare una funzione o null.
Un uso tipico riguarda l’elemento dialog: cancel segnala una richiesta di chiusura, non una chiusura già avvenuta. Il metodo requestClose() attiva prima cancel; il metodo close() salta questo passaggio. L’evento close indica invece la chiusura.
Quando event.cancelable è true, event.preventDefault() impedisce la chiusura predefinita. Anche restituire false da un gestore oncancel annulla l’evento, se è annullabile. Non dare per scontato che ogni richiesta di chiusura possa essere bloccata.
L’esempio apre una finestra di dialogo non modale e chiama requestClose(). L’attributo impedisce la chiusura, quindi il risultato registrato è open: true. Il close() finale rimuove la finestra dalla visualizzazione senza attivare di nuovo cancel.
Esempi
<!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>Risultato
open: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.