CKTIS / JavaScript
Формуляри и проверка за валидност
Използвай `input`, за да реагираш на промени в поле, и `submit`, за да обработиш изпращането на формуляра след успешна стандартна проверка. `HTMLFormElement` предлага и методи за изрична проверка на валидността на формуляра.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement е интерфейсът в DOM на браузъра, който представя елемент form. Свойството form.elements дава достъп до контролите, свързани с формуляра. Това е уеб API, а не част от езика ECMAScript.
Следи за събитието input, за да реагираш на промени от потребителя, например да обновиш подсказка, докато той пише. Самото задаване на стойност на field.value в JavaScript не задейства input. Атрибутът required прави празното текстово поле невалидно. form.checkValidity() връща резултата като булева стойност. form.reportValidity() също връща булева стойност и показва на потребителя грешките при проверката, освен ако събитието invalid на съответната контрола не бъде отменено. Отмяната на това събитие не променя резултата от проверката: методът връща false, без да показва грешка за тази контрола.
При обикновен опит за изпращане браузърът първо проверява ограниченията. Ако някое поле е невалидно, браузърът блокира изпращането и събитието submit не се задейства. Ако проверката е успешна, submit се задейства върху формуляра, а не върху бутона. Извикването на event.preventDefault() в обработчика отменя изпращането по подразбиране.
Използвай form.requestSubmit(), за да стартираш същия процес от кода. Директното извикване на form.submit() пропуска както проверката за валидност, така и събитието submit. Проверката в браузъра помага на потребителите да поправят въведените данни, но не замества проверката на сървъра.
Примери
<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
<label>Name <input name="displayName" required></label>
<button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
const form = document.querySelector('#profile');
const field = form.elements.namedItem('displayName');
const log = document.querySelector('#log');
const append = (line) => { log.textContent += line + '\n'; };
field.addEventListener('input', () => {
append(`input: ${form.checkValidity()}`);
});
form.addEventListener('submit', (event) => {
event.preventDefault();
append(`submit: ${field.value}`);
});
append(`initial: ${form.checkValidity()}`);
</script>Резултат
initial: false input: true submit: A
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.