Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onformdata — gestión de la construcción de datos del formulario

El atributo onformdata define un controlador para el evento formdata. Permite consultar y modificar los datos del formulario después de construir la lista de entradas, tanto al enviar el formulario como al llamar a new FormData(form).

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<form onformdata="event.formData.set('source', 'demo')">…</form>

onformdata es un atributo de contenido de controlador de eventos para formdata. Aunque está disponible en elementos HTML, lo habitual es usarlo en el formulario donde se origina el evento. Su valor es código JavaScript, no un valor booleano. La propiedad JavaScript correspondiente, form.onformdata, acepta una función; otra opción es form.addEventListener('formdata', handler).

El evento se dispara después de construir la lista de entradas del formulario, incluso durante el envío y mediante new FormData(form). El objeto event es un FormDataEvent, y event.formData expone los datos recopilados como FormData. Los métodos set(), append() y delete() permiten modificarlos. Al enviar el formulario, estos cambios afectan al conjunto de datos enviado, pero no modifican los valores de los controles del formulario.

No confundas formdata con submit: llamar a new FormData(form) no envía el formulario. El evento formdata se propaga, pero no se puede cancelar; preventDefault() no detendrá el envío. Para cancelarlo, gestiona el evento submit.

El ejemplo construye los datos sin enviar el formulario. El código de onformdata añade la entrada source antes de que el constructor devuelva el resultado. Una Content Security Policy puede bloquear los controladores definidos en atributos; en ese entorno, usa addEventListener() en un script permitido.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes