Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti