Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onreset — gestire il ripristino dei moduli

L’attributo onreset contiene codice JavaScript che gestisce l’evento reset di un modulo. Il gestore viene eseguito prima che siano ripristinati i valori predefiniti e può annullare il ripristino.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

onreset="JavaScript code"

onreset è un attributo HTML per la gestione dell’evento reset. Il suo valore è codice JavaScript, non il nome di un evento né un valore booleano. Di solito si trova su un modulo; l’evento risale la gerarchia, quindi può gestirlo anche un elemento antenato.

Il ripristino tramite un pulsante type="reset" o form.reset() invia prima al modulo un evento reset annullabile. Solo in seguito i controlli vengono riportati allo stato predefinito, che non consiste necessariamente in valori vuoti. Durante la gestione, il gestore può ancora leggere i valori precedenti al ripristino.

Nel codice dell’attributo, event indica l’evento e this l’elemento che lo gestisce. event.preventDefault() o return false annulla il ripristino. return false da solo non interrompe la propagazione.

L’attributo onreset e la proprietà JavaScript form.onreset configurano lo stesso singolo gestore. In alternativa, form.addEventListener('reset', handler) consente di registrare più gestori in modo indipendente. Una politica CSP può bloccare il codice dell’attributo; l’esempio richiede che la sua esecuzione sia consentita.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onreset example</title>
<form id="demo" onreset="document.getElementById('log').textContent += 'during reset: ' + this.elements.namedItem('nickname').value + '\n';">
  <label>Nickname <input name="nickname" value="Ada"></label>
  <button type="reset">Reset</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.getElementById('demo');
  const field = form.elements.namedItem('nickname');
  field.value = 'Grace';
  form.reset();
  document.getElementById('log').textContent += 'after reset: ' + field.value;
</script>
</html>

Risultato

during reset: Grace
after reset: Ada

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