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

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"]]

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

Източници