CKTIS / JavaScript
HTMLFormElement.reset() — obnovitev privzetega stanja obrazca
HTMLFormElement.reset() obnovi privzeto stanje kontrolnikov, povezanih z obrazcem, namesto da bi jih samo izpraznila. Najprej sproži preklicljiv dogodek reset; preventDefault() prepreči obnovitev.
Različica: 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 je metoda brskalniškega API-ja DOM, ne pa del ECMAScripta. Klic form.reset() ne sprejme argumentov in vrne undefined. Podpirajo jo vsi glavni današnji brskalniški pogoni; sama različica Node.js ne dokazuje, da je ta API na voljo.
Ponastavitev zadeva ponastavljive kontrolnike, katerih lastnik obrazca je ciljni obrazec, ne le njegovih potomcev. Pri besedilnem input obnovi privzeto vrednost, pri potrditvenem polju pa privzeto stanje označenosti. To torej ne pomeni »izprazni vse«. Sprememba defaultValue spremeni vrednost, uporabljeno pri naslednji ponastavitvi; ne gre za nespremenljiv posnetek stanja ob nalaganju strani. Ponastavitev ne odstrani atributa disabled.
Pred spremembo kontrolnikov obrazec sproži dogodek reset, ki se širi in ga je mogoče preklicati. Klic event.preventDefault() v njegovem obravnavalniku ustavi ponastavitev. Branje vrednosti v sinhronem obravnavalniku tega dogodka se zgodi pred obnovitvijo. Spremembe, ki jih izvede ponastavitev, ne sprožijo dogodkov input.
Izogibaj se kontrolnikom z name="reset" ali id="reset": lahko zasenčijo metodo, zato form.reset() ni več mogoče poklicati. Ob takem konfliktu uporabi HTMLFormElement.prototype.reset.call(form). Primer prikazuje običajno ponastavitev in njeno preklicanje.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.