Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes