CKTIS / JavaScript
HTMLFormElement.reset() — vraćanje zadanog stanja obrasca
HTMLFormElement.reset() vraća zadano stanje kontrola povezanih s obrascem, umjesto da ih samo isprazni. Najprije šalje otkaziv događaj reset; preventDefault() zaustavlja vraćanje.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
form.reset()HTMLFormElement.reset metoda je pregledničkog DOM API-ja, a ne dio samog ECMAScripta. Poziv form.reset() ne prima argumente i vraća undefined. Podržavaju je svi današnji glavni preglednički pogoni; sama verzija Node.js-a ne dokazuje da je ovaj API dostupan.
Reset utječe na kontrole koje se mogu resetirati i čiji je vlasnik obrasca ciljni obrazac, a ne samo na njegove potomke. Za tekstualni input vraća zadanu vrijednost, a za potvrdni okvir zadano stanje označenosti. Dakle, ne znači „isprazni sve”. Promjena defaultValue mijenja vrijednost koja se koristi pri sljedećem resetu; nije riječ o nepromjenjivom snimku stanja pri učitavanju stranice. Reset ne uklanja atribut disabled.
Prije promjene kontrola obrazac šalje događaj reset koji se propagira i može se otkazati. Poziv event.preventDefault() u njegovu rukovatelju zaustavlja reset. Čitanje vrijednosti u sinkronom rukovatelju tog događaja događa se prije vraćanja. Promjene koje izvrši reset ne pokreću događaje input.
Izbjegavaj kontrole s name="reset" ili id="reset": mogu zasjeniti metodu, pa se form.reset() više ne može pozvati. Ako dođe do takvog sukoba, upotrijebi HTMLFormElement.prototype.reset.call(form). Primjer prikazuje i uobičajeni reset i njegovo otkazivanje.
Primjeri
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);Rezultat
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.