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

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

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

Източници