FormData()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers.
Le constructeur FormData() crée un nouvel objet FormData.
Note : Cette fonctionnalité est disponible dans Web Workers.
Syntaxe
var formData = new FormData(form);
Paramètres
formFacultatif-
Un element HTML
<form>— quand il est spécifié, l'objetFormDatasera rempli avec les clés/valeurs du formulaire en utilisant les noms de propriétés de chaque élément pour clé et les valeurs soumises. Cela encodera aussi le contenu des fichiers.
Exemples
La ligne suivante crée un objet FormData vide:
var formData = new FormData(); // Formulaire vide à cet instant
Vous pouvez ajouter un couple clé/valeur en utilisant FormData.append :
formData.append("username", "Chris");
Ou vous pouvez spécifier l'argument optionnel form à la création de l'objet FormData pour le pré-remplir avec les valeurs issues du formulaire spécifié :
<form id="myForm" name="myForm">
<div>
<label for="username">Enter name:</label>
<input type="text" id="username" name="username" />
</div>
<div>
<label for="useracc">Enter account number:</label>
<input type="text" id="useracc" name="useracc" />
</div>
<div>
<label for="userfile">Upload file:</label>
<input type="file" id="userfile" name="userfile" />
</div>
<input type="submit" value="Submit!" />
</form>
Note :
Seuls les champs de formulaires valides sont inclus dans un objet FormData, c'est-à-dire ceux qui portent un nom (attribut name), qui ne sont pas désactivés et qui sont cochés (boutons radio et cases à cocher) ou sélectionnés (une ou plusieurs options dans une sélection).
var myForm = document.getElementById("myForm");
formData = new FormData(myForm);
Spécifications
| Specification |
|---|
| XMLHttpRequest # dom-formdata |
Compatibilité des navigateurs
Chargement…