Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje