Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri