CKTIS / HTML
onclose — gestire un evento close
L’attributo onclose contiene codice JavaScript che gestisce l’evento close. Un uso tipico è reagire alla chiusura di un elemento dialog, per esempio leggendo il suo returnValue. Non serve a impedire la chiusura.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onclose="JavaScript statements"onclose è un attributo globale di gestione dell’evento close. Il suo valore è codice JavaScript, non un valore booleano. Può essere scritto su qualsiasi elemento HTML, ma la sua presenza da sola non fa sì che l’elemento emetta questo evento.
Un uso tipico riguarda l’elemento dialog. La chiamata a close() chiude una finestra di dialogo aperta e mette in coda un evento close. Nel gestore dell’attributo, this indica l’elemento ed event fornisce l’oggetto evento. Il risultato della chiusura si legge tramite this.returnValue.
L’evento close di un elemento dialog non si propaga e non può essere annullato. Per impedire una richiesta di chiusura, gestisci l’evento annullabile cancel; close() salta questa fase. La rimozione manuale dell’attributo open non attiva close.
Non confondere l’attributo con la proprietà JavaScript element.onclose, a cui si assegna una funzione, né con addEventListener('close', handler), che consente di registrare più listener. Nell’esempio, il gestore legge il risultato done e aggiorna il testo solo dopo la distribuzione dell’evento messo in coda.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
<p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
const dialog = document.getElementById('demo');
dialog.show();
dialog.close('done');
</script>Risultato
closed: done
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.