Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje