CKTIS / HTML
onformdata — gestão da construção dos dados do formulário
O atributo onformdata define um handler para o evento formdata. Permite consultar e modificar os dados do formulário depois de construída a lista de entradas, tanto durante o envio do formulário como ao chamar new FormData(form).
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata é um atributo de conteúdo de handler de eventos para formdata. Embora esteja disponível nos elementos HTML, é normalmente usado no formulário onde este evento tem origem. O seu valor é código JavaScript, não um valor booleano. A propriedade JavaScript correspondente, form.onformdata, aceita uma função; outra opção é usar form.addEventListener('formdata', handler).
O evento é desencadeado depois de construída a lista de entradas do formulário, incluindo durante o envio e através de new FormData(form). O objeto event é um FormDataEvent, e event.formData disponibiliza os dados recolhidos como FormData. Os métodos set(), append() e delete() permitem modificar esses dados. Durante o envio, as alterações afetam o conjunto de dados enviado, mas não alteram os valores dos controlos do formulário.
Não confundas formdata com submit: chamar new FormData(form) não envia o formulário. O evento formdata propaga-se, mas não pode ser cancelado; preventDefault() não impede o envio. Para cancelar o envio, trata antes o evento submit.
O exemplo constrói os dados sem enviar o formulário. O código em onformdata adiciona a entrada source antes de o construtor devolver o resultado. Uma Content Security Policy pode bloquear handlers definidos em atributos; nesse caso, usa addEventListener() num script permitido.
Exemplos
<!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>Resultado
[["topic","html"],["source","demo"]]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.