CKTIS / HTML
onformdata — gérer la construction des données de formulaire
L’attribut onformdata définit un gestionnaire pour l’événement formdata. Il permet d’examiner et de modifier les données du formulaire une fois la liste d’entrées construite, lors de l’envoi du formulaire comme lors de l’appel à new FormData(form).
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<form onformdata="event.formData.set('source', 'demo')">…</form>onformdata est un attribut de contenu de gestionnaire d’événement pour formdata. Bien qu’il soit disponible sur les éléments HTML, il s’utilise généralement sur le formulaire à l’origine de cet événement. Sa valeur est du code JavaScript, et non une valeur booléenne. La propriété JavaScript correspondante, form.onformdata, accepte une fonction ; on peut aussi utiliser form.addEventListener('formdata', handler).
L’événement se déclenche après la construction de la liste d’entrées du formulaire, notamment lors de son envoi et avec new FormData(form). L’objet event est un FormDataEvent, et event.formData expose les données recueillies sous forme de FormData. Les méthodes set(), append() et delete() permettent de les modifier. Lors de l’envoi, ces modifications affectent les données transmises, mais ne changent pas les valeurs des contrôles du formulaire.
Ne confondez pas formdata et submit : appeler new FormData(form) ne soumet pas le formulaire. L’événement formdata remonte dans l’arbre, mais il n’est pas annulable ; preventDefault() n’empêchera pas l’envoi. Pour l’annuler, gérez plutôt l’événement submit.
L’exemple construit les données sans soumettre le formulaire. Le code de onformdata ajoute l’entrée source avant que le constructeur ne renvoie son résultat. Une Content Security Policy peut bloquer les gestionnaires définis dans des attributs ; dans ce cas, utilisez addEventListener() dans un script autorisé.
Exemples
<!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>Résultat
[["topic","html"],["source","demo"]]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.