CKTIS / HTML
onsubmit — обработване на опит за изпращане на формуляр
Атрибутът onsubmit задава JavaScript код, който обработва събитието submit. Той позволява реакция при опит за изпращане на формуляр и отмяна на изпращането по подразбиране; не потвърждава, че данните са достигнали сървъра.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit е атрибут за обработване на събитието submit. Обикновено се поставя върху елемента form, а не върху бутона за изпращане. Макар да е наличен за всички HTML елементи, целта на това събитие е формулярът; събитието се разпространява към предците. Стойността на атрибута е JavaScript код, а не адресът на местоназначението на формуляра.
Събитието възниква преди изпращането по подразбиране, например след активиране на бутон за изпращане или извикване на form.requestSubmit(). Ако браузърът извършва проверка на ограниченията и формулярът не я премине, събитието submit не възниква. Методът form.submit() заобикаля както тази проверка, така и събитието submit.
Кодът на атрибута получава параметъра event. Извикването на event.preventDefault() или изпълнението на return false отменя изпращането по подразбиране. Това не спира разпространението на събитието. Самото извикване на функция, която връща false, без резултатът ѝ да бъде предаден с return, не отменя изпращането.
JavaScript може също да присвои функция на form.onsubmit; следващо присвояване заменя предишната функция за това свойство. Примерът използва атрибута, отменя изпращането и променя текста на статуса. JavaScript трябва да е разрешен, а правилата за сигурност трябва да позволяват вградени обработчици на събития.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
<button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>Резултат
Submission canceled
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.