diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/formdata/index.md | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/formdata/index.md')
-rw-r--r-- | files/fr/web/api/formdata/index.md | 100 |
1 files changed, 38 insertions, 62 deletions
diff --git a/files/fr/web/api/formdata/index.md b/files/fr/web/api/formdata/index.md index 8fbf318e86..12b77b0afa 100644 --- a/files/fr/web/api/formdata/index.md +++ b/files/fr/web/api/formdata/index.md @@ -9,79 +9,55 @@ tags: - XMLHttpRequest translation_of: Web/API/FormData --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>L'interface <code>FormData</code> permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode {{domxref("XMLHttpRequest.send()")}} de l'objet XMLHttpRequest. Il utilise le même format qu'utilise un formulaire si le type d'encodage est mis à <code>"multipart/form-data"</code>.</p> +L'interface `FormData` permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode {{domxref("XMLHttpRequest.send()")}} de l'objet XMLHttpRequest. Il utilise le même format qu'utilise un formulaire si le type d'encodage est mis à `"multipart/form-data"`. -<p>Vous pouvez également le passer directement au constructeur {{domxref("URLSearchParams")}} si vous souhaitez générer des paramètres de requête de la même manière qu'un {{HTMLElement("form")}} le ferait s'il utilisait une simple soumission <code>GET</code>.</p> +Vous pouvez également le passer directement au constructeur {{domxref("URLSearchParams")}} si vous souhaitez générer des paramètres de requête de la même manière qu'un {{HTMLElement("form")}} le ferait s'il utilisait une simple soumission `GET`. -<p>Un objet implémentant <code>FormData</code> peut être utilisé directement dans une structure {{jsxref("Statements/for...of", "for...of")}}, au lieu de {{domxref('FormData.entries()', 'entries()')}} : <code>for (var p of myFormData)</code> est équivalent à <code>for (var p of myFormData.entries())</code>.</p> +Un objet implémentant `FormData` peut être utilisé directement dans une structure {{jsxref("Statements/for...of", "for...of")}}, au lieu de {{domxref('FormData.entries()', 'entries()')}} : `for (var p of myFormData)` est équivalent à `for (var p of myFormData.entries())`. -<div class="note"> -<p><strong>Note :</strong> Cette fonctionnalité est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette fonctionnalité est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Constructeur">Constructeur</h2> +## Constructeur -<dl> - <dt>{{domxref("FormData.FormData","FormData()")}}</dt> - <dd>Crée un nouvel objet <code>FormData</code>.</dd> -</dl> +- {{domxref("FormData.FormData","FormData()")}} + - : Crée un nouvel objet `FormData`. -<h2 id="Méthodes">Méthodes</h2> +## Méthodes -<dl> - <dt>{{domxref("FormData.append()")}}</dt> - <dd>Ajoute une nouvelle valeur à une clé existante dans un objet <code>FormData</code>, ou ajoute la clé si elle n'existe pas encore.</dd> - <dt>{{domxref("FormData.delete()")}}</dt> - <dd>Supprime une paire clé/valeur d'un objet <code>FormData</code>.</dd> - <dt>{{domxref("FormData.entries()")}}</dt> - <dd>Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet.</dd> - <dt>{{domxref("FormData.get()")}}</dt> - <dd>Renvoie la première valeur associée à une clé donnée à partir d'un objet <code>FormData</code>.</dd> - <dt>{{domxref("FormData.getAll()")}}</dt> - <dd>Retourne un tableau de toutes les valeurs associées à une clé donnée à partir d'un <code>FormData</code>.</dd> - <dt>{{domxref("FormData.has()")}}</dt> - <dd>Renvoie un booléen indiquant si un objet <code>FormData</code> contient une certaine clé.</dd> - <dt>{{domxref("FormData.keys()")}}</dt> - <dd>Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.</dd> - <dt>{{domxref("FormData.set()")}}</dt> - <dd>Définit une nouvelle valeur pour une clé existante dans un objet <code>FormData</code>, ou ajoute la clé/valeur si elle n'existe pas encore.</dd> - <dt>{{domxref("FormData.values()")}}</dt> - <dd>Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.</dd> -</dl> +- {{domxref("FormData.append()")}} + - : Ajoute une nouvelle valeur à une clé existante dans un objet `FormData`, ou ajoute la clé si elle n'existe pas encore. +- {{domxref("FormData.delete()")}} + - : Supprime une paire clé/valeur d'un objet `FormData`. +- {{domxref("FormData.entries()")}} + - : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet. +- {{domxref("FormData.get()")}} + - : Renvoie la première valeur associée à une clé donnée à partir d'un objet `FormData`. +- {{domxref("FormData.getAll()")}} + - : Retourne un tableau de toutes les valeurs associées à une clé donnée à partir d'un `FormData`. +- {{domxref("FormData.has()")}} + - : Renvoie un booléen indiquant si un objet `FormData` contient une certaine clé. +- {{domxref("FormData.keys()")}} + - : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet. +- {{domxref("FormData.set()")}} + - : Définit une nouvelle valeur pour une clé existante dans un objet `FormData`, ou ajoute la clé/valeur si elle n'existe pas encore. +- {{domxref("FormData.values()")}} + - : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('XMLHttpRequest','#interface-formdata','FormData')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>FormData définit dans les specs XHR</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------------------ | ----------------------------------- | +| {{SpecName('XMLHttpRequest','#interface-formdata','FormData')}} | {{Spec2('XMLHttpRequest')}} | FormData définit dans les specs XHR | -<ul> -</ul> +## Compatibilité des navigateurs -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +{{Compat("api.FormData")}} +## Voir aussi - -<p>{{Compat("api.FormData")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest">Utilisation de XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utilisation des objects FormData </a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utilisation de XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utilisation des objects FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} |