CKTIS / JavaScript
HTMLFormElement.reset() — obnovení výchozího stavu formuláře
HTMLFormElement.reset() obnoví výchozí stav ovládacích prvků přiřazených k formuláři, místo aby je pouze vyprázdnila. Nejprve vyvolá zrušitelnou událost reset; preventDefault() obnovení zastaví.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
form.reset()HTMLFormElement.reset je metoda rozhraní DOM v prohlížeči, nikoli součást samotného ECMAScriptu. Volání form.reset() nepřijímá žádné argumenty a vrací undefined. Podporují ji všechny současné hlavní prohlížečové enginy; samotná verze Node.js nedokládá dostupnost tohoto API.
Reset se týká resetovatelných ovládacích prvků, jejichž vlastníkem formuláře je cílový formulář, nikoli pouze jeho potomků. U textového input obnoví výchozí hodnotu, u zaškrtávacího políčka výchozí stav zaškrtnutí. Neznamená tedy „všechno vyprázdnit“. Změna defaultValue změní hodnotu použitou při příštím resetu; nejde o neměnný snímek stavu při načtení stránky. Reset neodstraní atribut disabled.
Než se ovládací prvky změní, formulář vyvolá bublající, zrušitelnou událost reset. Volání event.preventDefault() v obslužné funkci reset zastaví. Čtení hodnot v synchronní obslužné funkci této události proběhne před obnovením. Změny provedené resetem nevyvolávají události input.
Vyhýbej se ovládacím prvkům s name="reset" nebo id="reset": mohou zastínit metodu, takže form.reset() už nebude možné zavolat. Pokud ke kolizi dojde, použij HTMLFormElement.prototype.reset.call(form). Příklad ukazuje běžný reset i jeho zrušení.
Pří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ýsledek
before reset: Grace after reset: Ada before reset: Lin after canceled reset: Lin
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.