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
Източници
- HTML Standard — Form submission algorithm
- HTML Standard — Constraints: Security
- HTMLFormElement: submit event
- Element: input event
- HTMLElement: change event
- HTMLFormElement: requestSubmit() method
- HTMLFormElement: submit() method
- Event: currentTarget property
- Event: preventDefault() method
- EventTarget: dispatchEvent() method