CKTIS / HTML
onformdata — обработване на създаването на данни от формуляр
Атрибутът onformdata задава обработчик за събитието formdata. Той позволява да преглеждате и променяте данните на формуляра след съставянето на списъка с записи — както при изпращане на формуляра, така и при извикване на new FormData(form).
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata е атрибут за обработчик на събитието formdata. Макар да е достъпен за HTML елементи, обикновено се използва върху формуляра, в който възниква това събитие. Стойността му е JavaScript код, а не булева стойност. Съответното JavaScript свойство form.onformdata приема функция; друга възможност е form.addEventListener('formdata', handler).
Събитието се задейства след съставянето на списъка със записи на формуляра, включително при изпращане и чрез new FormData(form). Обектът event е от тип FormDataEvent, а event.formData предоставя събраните данни като FormData. Методите set(), append() и delete() позволяват да променяте тези данни. При изпращане промените влияят на изпратения набор от данни, но не променят стойностите на контролите във формуляра.
Не бъркайте formdata със submit: извикването на new FormData(form) само по себе си не изпраща формуляра. Събитието formdata се разпространява към предците, но не може да бъде отменено; preventDefault() няма да спре изпращането. За да отмените изпращането, обработвайте submit.
Примерът създава данни, без да изпраща формуляра. Кодът в onformdata добавя записа source, преди конструкторът да върне резултата. Content Security Policy може да блокира обработчиците, зададени в атрибути; в такава среда използвайте addEventListener() в разрешен скрипт.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onformdata demo</title>
<form id="demo" onformdata="event.formData.set('source', 'demo')">
<input type="hidden" name="topic" value="html">
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const data = new FormData(form);
document.getElementById('result').textContent =
JSON.stringify(Array.from(data.entries()));
</script>
</html>Резултат
[["topic","html"],["source","demo"]]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.