FormData()
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
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 Standard # dom-formdata |
Compatibilité des navigateurs
BCD tables only load in the browser