База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLFormElement.reset() — възстановяване на състоянието по подразбиране на формуляр

HTMLFormElement.reset() възстановява състоянието по подразбиране на контролите, свързани с формуляр, вместо просто да ги изпразни. Първо изпраща отменяемо събитие reset; preventDefault() спира възстановяването.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

form.reset()

HTMLFormElement.reset е метод от браузърния DOM API, а не част от самия ECMAScript. Извикването form.reset() не приема аргументи и връща undefined. Всички основни съвременни браузърни енджини го поддържат; само версията на Node.js не доказва наличието на този API.

Нулирането засяга контролите, които могат да се нулират и чийто собственик на формуляр е целевият формуляр, а не само неговите наследници. При текстов input то възстановява стойността по подразбиране, а при квадратче за отметка — състоянието на отметката по подразбиране. Следователно не означава „изпразни всичко“. Промяната на defaultValue променя стойността, използвана при следващо нулиране; това не е неизменна снимка на състоянието при зареждане на страницата. Нулирането не премахва атрибута disabled.

Преди да промени контролите, формулярът изпраща разпространяващо се и отменяемо събитие reset. Извикването на event.preventDefault() в обработчика му спира нулирането. Прочитането на стойностите в синхронен обработчик на това събитие се случва преди възстановяването. Промените, направени от нулирането, не задействат събития input.

Избягвай контроли с name="reset" или id="reset": те могат да засенчат метода и така form.reset() вече да не може да бъде извикан. При такъв конфликт използвай HTMLFormElement.prototype.reset.call(form). Примерът показва както обичайно нулиране, така и отмяната му.

Примери

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);

Резултат

before reset: Grace
after reset: Ada
before reset: Lin
after canceled reset: Lin

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници