Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLFormElement.reset() — ripristinare lo stato predefinito di un modulo

HTMLFormElement.reset() ripristina lo stato predefinito dei controlli associati a un modulo, invece di limitarsi a svuotarli. Per prima cosa genera un evento reset annullabile; preventDefault() impedisce il ripristino.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

form.reset()

HTMLFormElement.reset è un metodo dell’API DOM del browser, non fa parte di ECMAScript. La chiamata form.reset() non accetta argomenti e restituisce undefined. Tutti i principali motori browser attuali lo supportano; la sola versione di Node.js non dimostra che questa API sia disponibile.

Il ripristino riguarda i controlli ripristinabili il cui proprietario del modulo è il modulo di destinazione, non soltanto i suoi discendenti. Per un input di testo ripristina il valore predefinito; per una casella di controllo ripristina lo stato selezionato predefinito. Non significa quindi «svuotare tutto». Modificare defaultValue cambia il valore usato al ripristino successivo; non è un’istantanea immutabile dello stato al caricamento della pagina. Il ripristino non rimuove l’attributo disabled.

Prima di modificare i controlli, il modulo genera un evento reset che si propaga e può essere annullato. Chiamare event.preventDefault() nel relativo gestore interrompe il ripristino. La lettura dei valori in un gestore sincrono di questo evento avviene prima del ripristino. Le modifiche effettuate dal ripristino non generano eventi input.

Evita controlli con name="reset" o id="reset": possono nascondere il metodo, rendendo form.reset() non più invocabile. Se si verifica questa collisione, usa HTMLFormElement.prototype.reset.call(form). L’esempio mostra sia un ripristino normale sia il suo annullamento.

Esempi

const form = document.createElement('form');
const input = document.createElement('input');
input.defaultValue = 'Ada';
form.append(input);

input.value = 'Grace';
form.addEventListener('reset', () => {
  console.log('before reset: ' + input.value);
});

form.reset();
console.log('after reset: ' + input.value);

input.value = 'Lin';
form.addEventListener('reset', event => event.preventDefault(), { once: true });
form.reset();
console.log('after canceled reset: ' + input.value);

Risultato

before reset: Grace
after reset: Ada
before reset: Lin
after canceled reset: Lin

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