CKTIS / JavaScript
HTMLFormElement.reset() — obnovenie predvoleného stavu formulára
HTMLFormElement.reset() obnoví predvolený stav ovládacích prvkov priradených k formuláru, namiesto toho, aby ich iba vyprázdnila. Najprv vyvolá zrušiteľnú udalosť reset; preventDefault() obnovenie zastaví.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
form.reset()HTMLFormElement.reset je metóda rozhrania DOM v prehliadači, nie súčasť samotného ECMAScriptu. Volanie form.reset() neprijíma žiadne argumenty a vracia undefined. Podporujú ju všetky súčasné hlavné prehliadačové enginy; samotná verzia Node.js nedokazuje dostupnosť tohto API.
Reset sa týka resetovateľných ovládacích prvkov, ktorých vlastníkom formulára je cieľový formulár, nielen jeho potomkov. Pri textovom input obnoví predvolenú hodnotu, pri zaškrtávacom políčku predvolený stav začiarknutia. Neznamená teda „všetko vyprázdniť“. Zmena defaultValue zmení hodnotu použitú pri ďalšom resete; nejde o nemennú snímku stavu pri načítaní stránky. Reset neodstráni atribút disabled.
Skôr než sa ovládacie prvky zmenia, formulár vyvolá bublajúcu, zrušiteľnú udalosť reset. Volanie event.preventDefault() v obslužnej funkcii reset zastaví. Čítanie hodnôt v synchrónnej obslužnej funkcii tejto udalosti prebehne pred obnovením. Zmeny vykonané resetom nevyvolávajú udalosti input.
Vyhýbaj sa ovládacím prvkom s name="reset" alebo id="reset": môžu zatieniť metódu, takže form.reset() už nebude možné zavolať. Ak dôjde ku kolízii, použi HTMLFormElement.prototype.reset.call(form). Príklad ukazuje bežný reset aj jeho zrušenie.
Príklady
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);Výsledok
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.