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

CKTIS / JavaScript

Събитията `submit` и `input` в HTML формуляри

Използвай `input`, за да реагираш на редакции, и `submit`, за да обработваш изпращането на формуляра в правилния момент от проверката.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();

input възниква върху редактираното поле и се разпространява нагоре по DOM дървото. В обработчик на формуляра event.target сочи полето, а event.currentTarget сочи формуляра, докато обработчикът се изпълнява. Ако полето е извън формуляра и е свързано с него чрез атрибута form, само тази връзка не пренася събитието до формуляра. Използвай input за обратна връзка по време на редактиране; change отбелязва потвърдена промяна, обикновено при загуба на фокус в текстово поле. Присвояването на .value само по себе си не предизвиква input.

submit възниква върху формуляра, не върху бутона. Това е SubmitEvent, което се разпространява нагоре и чието действие по подразбиране може да се отмени. Слушай за него вместо за click върху бутона, за да обхванеш и неявното изпращане, например с Enter, ако браузърът го поддържа. event.submitter сочи бутона за изпращане или е null, ако изпращането не е задействано от бутон. За да спреш изпращането по подразбиране, извикай event.preventDefault() в обработчика преди всяко await.

form.requestSubmit() следва обичайните правила за изпращане, без да избира бутон. form.requestSubmit(button) използва посочения бутон и зачита неговите настройки, например formaction и formnovalidate. Ако проверката на ограниченията не е пропусната и е неуспешна, невалидните полета получават invalid, а submit не възниква. Елемент, който не е бутон за изпращане, предизвиква TypeError; бутон за изпращане, който не принадлежи на този формуляр, предизвиква NotFoundError.

Прякото извикване на form.submit() пропуска проверката на ограниченията и не предизвиква submit. Поле с name или id със стойност submit може да закрие метода. Проверката в браузъра не замества проверката на сървъра. Това са API на уеб платформата, не част от ECMAScript 2024; провери поддръжката в целевата среда.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement("form");
  const field = document.createElement("input");
  field.type = "text";
  field.required = true;

  const button = document.createElement("button");
  button.type = "submit";
  button.value = "save";
  button.textContent = "Save";
  form.append(field, button);

  field.addEventListener("invalid", (event) => {
    event.preventDefault();
    console.log("invalid");
  });
  form.addEventListener("input", (event) => {
    if (event.target === field) console.log(`input: ${field.value}`);
  });
  form.addEventListener("submit", (event) => {
    event.preventDefault();
    console.log(`submit: ${event.submitter.value}`);
  });

  document.body.append(form);
  try {
    form.requestSubmit(button);
    field.value = "Ada";
    console.log(`set: ${field.value}`);
    field.dispatchEvent(new Event("input", { bubbles: true }));
    form.requestSubmit(button);
  } finally {
    form.remove();
  }
})();
</script>
</body>
</html>

Резултат

invalid
set: Ada
input: Ada
submit: save

Запази примера като HTML файл и го отвори в браузър. Отвори конзолата и презареди страницата. Първата заявка извежда `invalid`. След `set: Ada` само ръчно задействаното събитие извежда `input: Ada`; втората заявка извежда `submit: save`, но обработчикът отменя изпращането.

Свързани уроци

  • JavaScript · Урок 15 · Напреднало · Версия: 4

Източници