diff options
author | Carolyn Wu <87150472+cw118@users.noreply.github.com> | 2022-01-15 03:38:16 -0500 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-01-15 09:38:16 +0100 |
commit | 551ef486125d0578ec4a701ed33503c825125ce0 (patch) | |
tree | a3cfcfcc11ef8720f9389b2c132333485d6a9160 | |
parent | 0eb5adccf61b847c71a799e8c0bb0346d73f9f9d (diff) | |
download | translated-content-551ef486125d0578ec4a701ed33503c825125ce0.tar.gz translated-content-551ef486125d0578ec4a701ed33503c825125ce0.tar.bz2 translated-content-551ef486125d0578ec4a701ed33503c825125ce0.zip |
Small fix and updates for FormData (#3688)
* Small fix and updates for fr FormData
* Minor typofixing
Co-authored-by: julieng <julien.gattelier@gmail.com>
-rw-r--r-- | files/fr/web/api/formdata/index.md | 55 |
1 files changed, 24 insertions, 31 deletions
diff --git a/files/fr/web/api/formdata/index.md b/files/fr/web/api/formdata/index.md index 12b77b0afa..0ce566ac24 100644 --- a/files/fr/web/api/formdata/index.md +++ b/files/fr/web/api/formdata/index.md @@ -1,63 +1,56 @@ --- title: FormData slug: Web/API/FormData -tags: - - API - - FormData - - Interface - - Reference - - XMLHttpRequest translation_of: Web/API/FormData +browser-compat: api.FormData --- {{APIRef("XMLHttpRequest")}} -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"`. +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 [`XMLHttpRequest.send()`](/fr/docs/Web/API/XMLHttpRequest/send) de l'objet `XMLHttpRequest`. Elle utilise le même format qu'utilise un formulaire si le type d'encodage est mis à `"multipart/form-data"`. -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`. +Vous pouvez également le passer directement au constructeur [`URLSearchParams`](/fr/docs/Web/API/URLSearchParams) si vous souhaitez générer des paramètres de requête de la même manière qu'un [`<form>`](/fr/docs/Web/HTML/Element/Form) le ferait s'il utilisait une simple soumission `GET`. -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())`. +Un objet implémentant `FormData` peut être utilisé directement dans une structure [`for…of`](/fr/docs/Web/JavaScript/Reference/Statements/for...of), au lieu de [`entries()`](/fr/docs/Web/API/FormData/entries) : `for (var p of myFormData)` est équivalent à `for (var p of myFormData.entries())`. > **Note :** Cette fonctionnalité est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). ## Constructeur -- {{domxref("FormData.FormData","FormData()")}} +- [`FormData()`](/fr/docs/Web/API/FormData/FormData) - : Crée un nouvel objet `FormData`. ## Méthodes -- {{domxref("FormData.append()")}} +- [`FormData.append()`](/fr/docs/Web/API/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()")}} +- [`FormData.delete()`](/fr/docs/Web/API/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()")}} +- [`FormData.entries()`](/fr/docs/Web/API/FormData/entries) + - : Renvoie un [itérateur](/fr/docs/Web/JavaScript/Reference/Iteration_protocols) permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet. +- [`FormData.get()`](/fr/docs/Web/API/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()")}} +- [`FormData.getAll()`](/fr/docs/Web/API/FormData/getAll) + - : Renvoie un tableau de toutes les valeurs associées à une clé donnée à partir d'un objet `FormData`. +- [`FormData.has()`](/fr/docs/Web/API/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()")}} +- [`FormData.keys()`](/fr/docs/Web/API/FormData/keys) + - : Renvoie un [itérateur](/fr/docs/Web/JavaScript/Reference/Iteration_protocols) permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet. +- [`FormData.set()`](/fr/docs/Web/API/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. +- [`FormData.values()`](/fr/docs/Web/API/FormData/values) + - : Renvoie un [itérateur](/fr/docs/Web/JavaScript/Reference/Iteration_protocols) permettant de parcourir toutes les valeurs contenues dans cet objet. ## Spécifications -| Spécification | Statut | Commentaire | -| ------------------------------------------------------------------------------------ | ------------------------------------ | ----------------------------------- | -| {{SpecName('XMLHttpRequest','#interface-formdata','FormData')}} | {{Spec2('XMLHttpRequest')}} | FormData définit dans les specs XHR | +{{Specifications}} ## Compatibilité des navigateurs -{{Compat("api.FormData")}} +{{Compat}} ## Voir aussi -- {{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")}} +- [`XMLHttpRequest`](/fr/docs/Web/API/XMLHttpRequest) +- [Utilisation de `XMLHttpRequest`](/fr/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- [Utilisation des objets `FormData`](/fr/docs/Web/API/FormData/Using_FormData_Objects) +- [`<form>`](/fr/docs/Web/HTML/Element/Form) |