diff options
Diffstat (limited to 'files/fr/web/api/formdata')
| -rw-r--r-- | files/fr/web/api/formdata/append/index.md | 107 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/delete/index.md | 78 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/entries/index.md | 70 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/formdata/index.md | 119 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/get/index.md | 66 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/getall/index.md | 85 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/has/index.md | 78 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/index.md | 100 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/keys/index.md | 66 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/set/index.md | 101 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/using_formdata_objects/index.md | 117 | ||||
| -rw-r--r-- | files/fr/web/api/formdata/values/index.md | 66 |
12 files changed, 450 insertions, 603 deletions
diff --git a/files/fr/web/api/formdata/append/index.md b/files/fr/web/api/formdata/append/index.md index 80ab87cb3f..6c0450b234 100644 --- a/files/fr/web/api/formdata/append/index.md +++ b/files/fr/web/api/formdata/append/index.md @@ -11,88 +11,75 @@ tags: - XMLHttpRequest translation_of: Web/API/FormData/append --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code><strong>append()</strong></code> de l'interface {{domxref("FormData")}} ajoute une nouvelle valeur à une clé existante dans un objet <code>FormData</code>, ou rajoute cette clé et cette valeur quand elle n'existe pas.</p> +La méthode **`append()`** de l'interface {{domxref("FormData")}} ajoute une nouvelle valeur à une clé existante dans un objet `FormData`, ou rajoute cette clé et cette valeur quand elle n'existe pas. -<p>La différence entre {{domxref("FormData.set")}} et <code>append()</code> est que, quand la clé existe, {{domxref("FormData.set")}} va remplacer les valeurs existantes avec la nouvelle alors qu' <code>append()</code> va rajouter celle-ci à la fin de l'ensemble des valeurs existantes.</p> +La différence entre {{domxref("FormData.set")}} et `append()` est que, quand la clé existe, {{domxref("FormData.set")}} va remplacer les valeurs existantes avec la nouvelle alors qu' `append()` va rajouter celle-ci à la fin de l'ensemble des valeurs existantes. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/en-US/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<p>Il y a deux versions de cette méthode : avec deux ou trois paramètres</p> +Il y a deux versions de cette méthode : avec deux ou trois paramètres -<pre class="brush: js">formData.append(name, value); -formData.append(name, value, filename);</pre> +```js +formData.append(name, value); +formData.append(name, value, filename); +``` -<h3 id="append_Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Le nom de la clé dont les données sont contenues dans <code>value</code>.</dd> - <dt><code>value</code></dt> - <dd>La valeur du champ clé. Elle peut être une {{domxref("USVString")}} ou un {{domxref("Blob")}} (incluant les sous-classes comme {{domxref("File")}}).</dd> - <dt><code>filename </code>{{optional_inline}}</dt> - <dd>Le nom du fichier envoyé au serveur (a {{domxref("USVString")}}), quand un {{domxref("Blob")}} ou un {{domxref("File")}} est passé en second paramètre. Le nom du fichier par défaut pour des objets {{domxref("Blob")}} est "blob". Le nom du fichier par défaut pour des objets {{domxref("File")}} est le nom du fichier de l'objet.</dd> -</dl> +- `name` + - : Le nom de la clé dont les données sont contenues dans `value`. +- `value` + - : La valeur du champ clé. Elle peut être une {{domxref("USVString")}} ou un {{domxref("Blob")}} (incluant les sous-classes comme {{domxref("File")}}). +- `filename `{{optional_inline}} + - : Le nom du fichier envoyé au serveur (a {{domxref("USVString")}}), quand un {{domxref("Blob")}} ou un {{domxref("File")}} est passé en second paramètre. Le nom du fichier par défaut pour des objets {{domxref("Blob")}} est "blob". Le nom du fichier par défaut pour des objets {{domxref("File")}} est le nom du fichier de l'objet. -<div class="note"> -<p><strong>Note:</strong> Si vous spécifiez un {{domxref("Blob")}} comme donnée rattachée à un objet de type <code>FormData</code>, le nom de fichier envoyé au serveur sera dans l'entête "Content-Disposition" mais peut varier selon le navigateur.</p> -</div> +> **Note :** Si vous spécifiez un {{domxref("Blob")}} comme donnée rattachée à un objet de type `FormData`, le nom de fichier envoyé au serveur sera dans l'entête "Content-Disposition" mais peut varier selon le navigateur. -<h3 id="Retours">Retours</h3> +### Retours -<p>Void.</p> +Void. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide :</p> +La ligne suivante crée un objet `FormData` vide : -<pre class="brush: js">var formData = new FormData(); // Actuellement vide</pre> +```js +var formData = new FormData(); // Actuellement vide +``` -<p>Vous pouvez rajouter des paires clé/valeur en utilisant {{domxref("FormData.append")}}:</p> +Vous pouvez rajouter des paires clé/valeur en utilisant {{domxref("FormData.append")}}: -<pre class="brush: js">formData.append('username', 'Chris'); -formData.append('userpic', myFileInput.files[0], 'chris.jpg');</pre> +```js +formData.append('username', 'Chris'); +formData.append('userpic', myFileInput.files[0], 'chris.jpg'); +``` -<p>Comme pour un formulaire classique, vous pouvez ajouter plusieurs valeurs pour la même clé. Par exemple ( et pour être en accord avec les conventions de nommage PHP, on ajoute [] au nom de la clé):</p> +Comme pour un formulaire classique, vous pouvez ajouter plusieurs valeurs pour la même clé. Par exemple ( et pour être en accord avec les conventions de nommage PHP, on ajoute \[] au nom de la clé): -<pre class="brush: js">formData.append('userpic[]', myFileInput.files[0], 'chris1.jpg'); -formData.append('userpic[]', myFileInput.files[1], 'chris2.jpg');</pre> +```js +formData.append('userpic[]', myFileInput.files[0], 'chris1.jpg'); +formData.append('userpic[]', myFileInput.files[1], 'chris2.jpg'); +``` -<p>Cette technique permet de simplement gérer l'envoi de plusieurs fichiers avec l'envoi d'une structure facilement itérable.</p> +Cette technique permet de simplement gérer l'envoi de plusieurs fichiers avec l'envoi d'une structure facilement itérable. -<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','#dom-formdata-append','append()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------------------ | ------------------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-append','append()')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.append")}} +## Voir aussi -<p>{{Compat("api.FormData.append")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/delete/index.md b/files/fr/web/api/formdata/delete/index.md index 551431a588..737804897a 100644 --- a/files/fr/web/api/formdata/delete/index.md +++ b/files/fr/web/api/formdata/delete/index.md @@ -11,68 +11,54 @@ tags: - delete translation_of: Web/API/FormData/delete --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code><strong>delete()</strong></code> de l'interface {{domxref("FormData")}} supprime une clé et sa (ses) valeur(s) d'un objet <code>FormData</code>.</p> +La méthode **`delete()`** de l'interface {{domxref("FormData")}} supprime une clé et sa (ses) valeur(s) d'un objet `FormData`. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">formData.delete(name);</pre> +```js +formData.delete(name); +``` -<h3 id="append_Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Le nom de la clé que vous voulez supprimer.</dd> -</dl> +- `name` + - : Le nom de la clé que vous voulez supprimer. -<h3 id="Retours">Retours</h3> +### Retours -<p>Void.</p> +Void. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide et le pré-remplit avec les paires clé/valeur d'un formulaire :</p> +La ligne suivante crée un objet `FormData` vide et le pré-remplit avec les paires clé/valeur d'un formulaire : -<pre class="brush: js">var formData = new FormData(myForm);</pre> +```js +var formData = new FormData(myForm); +``` -<p>Vous pouvez supprimer les clés et leurs valeurs en utilisant <code>delete()</code>:</p> +Vous pouvez supprimer les clés et leurs valeurs en utilisant `delete()`: -<pre class="brush: js">formData.delete('username'); -</pre> +```js +formData.delete('username'); +``` -<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','#dom-formdata-delete','delete()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-delete','delete()')}} | {{Spec2('XMLHttpRequest')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.delete")}} +## Voir aussi -<p>{{Compat("api.FormData.delete")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/entries/index.md b/files/fr/web/api/formdata/entries/index.md index dc940b71b6..b8c8df5899 100644 --- a/files/fr/web/api/formdata/entries/index.md +++ b/files/fr/web/api/formdata/entries/index.md @@ -11,26 +11,25 @@ tags: - XMLHttpRequest translation_of: Web/API/FormData/entries --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La methode <strong>FormData.entries()</strong> retourne un {{jsxref("Les_protocoles_iteration",'iterateur')}} permettant d'accéder aux paires clefs/valeurs contenues dans cet objet.<br> - La clef de chaque paire est une {{domxref("USVString")}}. De la même manière, la valeur peut être une {{domxref("USVString")}} ou un {{domxref("Blob")}}.</p> +La methode **FormData.entries()** retourne un {{jsxref("Les_protocoles_iteration",'iterateur')}} permettant d'accéder aux paires clefs/valeurs contenues dans cet objet. +La clef de chaque paire est une {{domxref("USVString")}}. De la même manière, la valeur peut être une {{domxref("USVString")}} ou un {{domxref("Blob")}}. -<div class="note"> -<p><strong>Note :</strong> Cette methode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette methode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">formData.entries();</pre> + formData.entries(); -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Retourne un {{jsxref("Les_protocoles_iteration","iterateur")}}.</p> +Retourne un {{jsxref("Les_protocoles_iteration","iterateur")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Creation d'un objet FormData +```js +// Creation d'un objet FormData var formData = new FormData(); formData.append('key1', 'value1'); formData.append('key2', 'value2'); @@ -39,43 +38,26 @@ formData.append('key2', 'value2'); for(var pair of formData.entries()) { console.log(pair[0]+ ', '+ pair[1]); } -</pre> +``` -<p>Le resultat est:</p> +Le resultat est: -<pre>key1, value1 -key2, value2</pre> + key1, value1 + key2, value2 -<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','#dom-formdata','entries() (as iterator<>)')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------- | +| {{SpecName('XMLHttpRequest','#dom-formdata','entries() (as iterator<>)')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale | -<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> +## Compatibilité navigateurs -<div> +{{Compat("api.FormData.entries")}} +## Voir aussi -<p>{{Compat("api.FormData.entries")}}</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/formdata/index.md b/files/fr/web/api/formdata/formdata/index.md index 3852b6d2be..5e9b2e5cc1 100644 --- a/files/fr/web/api/formdata/formdata/index.md +++ b/files/fr/web/api/formdata/formdata/index.md @@ -10,90 +10,77 @@ tags: - XMLHttpRequest translation_of: Web/API/FormData/FormData --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>Le constructeur <code><strong>FormData()</strong></code> crée un nouvel objet {{domxref("FormData")}}.</p> +Le constructeur **`FormData()`** crée un nouvel objet {{domxref("FormData")}}. -<div class="note"> -<p><strong>Note :</strong> Cette fonctionnalité est disponible dans <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette fonctionnalité est disponible dans [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"><code>var formData = new FormData(</code><code>form</code><code>)</code></pre> +```js +var formData = new FormData(form) +``` -<h3 id="Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>form </code>{{optional_inline}}</dt> - <dd>Un element HTML {{HTMLElement("form")}} — quand il est spécifié, l'objet {{domxref("FormData")}} sera 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.</dd> -</dl> +- `form `{{optional_inline}} + - : Un element HTML {{HTMLElement("form")}} — quand il est spécifié, l'objet {{domxref("FormData")}} sera 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. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>La ligne suivante crée un objet <code>FormData</code> vide:</p> +La ligne suivante crée un objet `FormData` vide: -<pre class="brush: js">var formData = new FormData(); // Formulaire vide à cet instant</pre> +```js +var formData = new FormData(); // Formulaire vide à cet instant +``` -<p>Vous pouvez ajouter un couple clé/valeur en utilisant {{domxref("FormData.append")}} :</p> +Vous pouvez ajouter un couple clé/valeur en utilisant {{domxref("FormData.append")}} : -<pre class="brush: js">formData.append('username', 'Chris'); -</pre> +```js +formData.append('username', 'Chris'); +``` -<p>Ou vous pouvez spécifier l'argument optionnel <code><em>form</em></code> à la création de l'objet <code>FormData</code> pour le pré-remplir avec les valeurs issues du formulaire spécifié :</p> +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é : -<pre class="brush: html"><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> -</pre> +```html +<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> +``` -<div class="note"> -<p><strong>Note :</strong> Seuls les champs de formulaires valides sont inclus dans un objet FormData, c'est-à-dire ceux qui portent un nom (attribut <code>name</code>), 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).</p> -</div> +> **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). -<pre class="brush: js">var myForm = document.getElementById('myForm'); -formData = new FormData(myForm);</pre> +```js +var myForm = document.getElementById('myForm'); +formData = new FormData(myForm); +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('XMLHttpRequest','#dom-formdata','FormData()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('XMLHttpRequest','#dom-formdata','FormData()')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.FormData.FormData")}}</p> +{{Compat("api.FormData.FormData")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">Manipuler <code>XMLHttpRequest</code></a></li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects">Utiliser les objets <code>FormData</code></a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Manipuler `XMLHttpRequest`](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest) +- [Utiliser les objets `FormData`](/fr/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/get/index.md b/files/fr/web/api/formdata/get/index.md index 5eec93c7e9..d5b08c1c1c 100644 --- a/files/fr/web/api/formdata/get/index.md +++ b/files/fr/web/api/formdata/get/index.md @@ -4,63 +4,59 @@ slug: Web/API/FormData/get translation_of: Web/API/FormData/get browser-compat: api.FormData.get --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <strong><code>get()</code></strong> de l'interface <a href="/fr/docs/Web/API/FormData"><code>FormData</code></a> renvoie la première valeur associée à une clé donnée dans un objet <code>FormData</code>. Si vous souhaitez manipuler plusieurs valeurs et les récupérer intégralement, utilisez plutôt la méthode <a href="/fr/docs/Web/API/FormData/getAll"><code>getAll()</code></a>.</p> +La méthode **`get()`** de l'interface [`FormData`](/fr/docs/Web/API/FormData) renvoie la première valeur associée à une clé donnée dans un objet `FormData`. Si vous souhaitez manipuler plusieurs valeurs et les récupérer intégralement, utilisez plutôt la méthode [`getAll()`](/fr/docs/Web/API/FormData/getAll). -<div class="note"> - <p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">formData.get(name);</pre> +```js +formData.get(name); +``` -<h3 id="append_Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Une chaîne de caractères <a href="/fr/docs/Web/API/USVString"><code>USVString</code></a> représentant le nom de la clé que vous souhaitez retrouver.</dd> -</dl> +- `name` + - : Une chaîne de caractères [`USVString`](/fr/docs/Web/API/USVString) représentant le nom de la clé que vous souhaitez retrouver. -<h3 id="Return_value">Valeur de retour</h3> +### Valeur de retour -<p>Un objet <a href="/fr/docs/Web/API/FormDataEntryValue"><code>FormDataEntryValue</code></a> contenant la valeur. Si la clé n'existe pas, la méthode renvoie <code>null</code>.</p> +Un objet [`FormDataEntryValue`](/fr/docs/Web/API/FormDataEntryValue) contenant la valeur. Si la clé n'existe pas, la méthode renvoie `null`. -<h2 id="example">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide :</p> +La ligne suivante crée un objet `FormData` vide : -<pre class="brush: js"> +```js var formData = new FormData(); -</pre> +``` -<p>Si nous ajoutons deux valeurs <code>username</code> en utilisant <a href="/fr/docs/Web/API/FormData/append"><code>FormData.append</code></a> :</p> +Si nous ajoutons deux valeurs `username` en utilisant [`FormData.append`](/fr/docs/Web/API/FormData/append) : -<pre class="brush: js"> +```js formData.append('username', 'Chris'); formData.append('username', 'Bob'); -</pre> +``` -<p>L'appel suivant à <code>get()</code> renverra uniquement la première valeur <code>username</code> indexée :</p> +L'appel suivant à `get()` renverra uniquement la première valeur `username` indexée : -<pre class="brush: js"> +```js formData.get('username'); // Renvoie "Chris" -</pre> +``` -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/XMLHttpRequest"><code>XMLHTTPRequest</code></a></li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Using_FormData_Objects">Utiliser les objets <code>FormData</code></a></li> - <li><a href="/fr/docs/Web/HTML/Element/Form"><code><form></code></a></li> -</ul> +- [`XMLHTTPRequest`](/fr/docs/Web/API/XMLHttpRequest) +- [Utiliser XMLHttpRequest](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest) +- [Utiliser les objets `FormData`](/fr/docs/Web/API/FormData/Using_FormData_Objects) +- [`<form>`](/fr/docs/Web/HTML/Element/Form) diff --git a/files/fr/web/api/formdata/getall/index.md b/files/fr/web/api/formdata/getall/index.md index 2b1ced7864..c61386e768 100644 --- a/files/fr/web/api/formdata/getall/index.md +++ b/files/fr/web/api/formdata/getall/index.md @@ -11,72 +11,61 @@ tags: - getAll translation_of: Web/API/FormData/getAll --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code><strong>getAll()</strong></code> de l'interface {{domxref("FormData")}} renvoie toutes les valeurs associées à une clé donnée à partir d'un objet <code>FormData</code>.</p> +La méthode **`getAll()`** de l'interface {{domxref("FormData")}} renvoie toutes les valeurs associées à une clé donnée à partir d'un objet `FormData`. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">formData.getAll(name);</pre> +```js +formData.getAll(name); +``` -<h3 id="append_Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Un {{domxref("USVString")}} représentant le nom de la clé que vous voulez récupérer.</dd> -</dl> +- `name` + - : Un {{domxref("USVString")}} représentant le nom de la clé que vous voulez récupérer. -<h3 id="Retours">Retours</h3> +### Retours -<p>Un tableau de {{domxref("FormDataEntryValue")}} dont la clé correspond à la valeur passée dans le paramètre <code>name</code>. Si la clé n'existe pas, la méthode renvoie une liste vide.</p> +Un tableau de {{domxref("FormDataEntryValue")}} dont la clé correspond à la valeur passée dans le paramètre `name`. Si la clé n'existe pas, la méthode renvoie une liste vide. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide :</p> +La ligne suivante crée un objet `FormData` vide : -<pre class="brush: js">var formData = new FormData();</pre> +```js +var formData = new FormData(); +``` -<p>Si nous ajoutons deux valeurs <code>username</code> en utilisant {{domxref("FormData.append")}} :</p> +Si nous ajoutons deux valeurs `username` en utilisant {{domxref("FormData.append")}} : -<pre class="brush: js">formData.append('username', 'Chris'); -formData.append('username', 'Bob');</pre> +```js +formData.append('username', 'Chris'); +formData.append('username', 'Bob'); +``` -<p>La fonction <code>getAll()</code> suivante va retourner chaque valeurs de <code>username</code> dans un tableau :</p> +La fonction `getAll()` suivante va retourner chaque valeurs de `username` dans un tableau : -<pre class="brush: js">formData.getAll('username'); // Returns ["Chris", "Bob"]</pre> +```js +formData.getAll('username'); // Returns ["Chris", "Bob"] +``` -<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','#dom-formdata-getall','getAll()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-getall','getAll()')}} | {{Spec2('XMLHttpRequest')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.getAll")}} +## Voir aussi -<p>{{Compat("api.FormData.getAll")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/has/index.md b/files/fr/web/api/formdata/has/index.md index 2915f9d65a..b167e01317 100644 --- a/files/fr/web/api/formdata/has/index.md +++ b/files/fr/web/api/formdata/has/index.md @@ -11,70 +11,56 @@ tags: - has translation_of: Web/API/FormData/has --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code><strong>has()</strong></code> de l'interface {{domxref("FormData")}} renvoie un booléen indiquant si un objet <code>FormData</code> contient une certaine clé.</p> +La méthode **`has()`** de l'interface {{domxref("FormData")}} renvoie un booléen indiquant si un objet `FormData` contient une certaine clé. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">formData.has(name);</pre> +```js +formData.has(name); +``` -<h3 id="append_Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Un {{domxref("USVString")}} représentant le nom de la clé que vous voulez tester.</dd> -</dl> +- `name` + - : Un {{domxref("USVString")}} représentant le nom de la clé que vous voulez tester. -<h3 id="Retours">Retours</h3> +### Retours -<p>Un {{domxref("Boolean")}}.</p> +Un {{domxref("Boolean")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide :</p> +La ligne suivante crée un objet `FormData` vide : -<pre class="brush: js">var formData = new FormData();</pre> +```js +var formData = new FormData(); +``` -<p>L'extrait suivant montre les résultats des tests effectués pour vérifier l'existence d'un <code>username</code> dans l'objet FormData, avant et après avoir ajouté une valeur <code>username</code> avec {{domxref("FormData.append")}} :</p> +L'extrait suivant montre les résultats des tests effectués pour vérifier l'existence d'un `username` dans l'objet FormData, avant et après avoir ajouté une valeur `username` avec {{domxref("FormData.append")}} : -<pre class="brush: js">formData.has('username'); // Retourne false +```js +formData.has('username'); // Retourne false formData.append('username', 'Chris'); formData.has('username'); // Retourne true -</pre> +``` -<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','#dom-formdata-has','has()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-has','has()')}} | {{Spec2('XMLHttpRequest')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.has")}} +## Voir aussi -<p>{{Compat("api.FormData.has")}}</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")}} 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")}} diff --git a/files/fr/web/api/formdata/keys/index.md b/files/fr/web/api/formdata/keys/index.md index 3b3b55c86c..e41b139f4b 100644 --- a/files/fr/web/api/formdata/keys/index.md +++ b/files/fr/web/api/formdata/keys/index.md @@ -12,25 +12,24 @@ tags: - keys translation_of: Web/API/FormData/keys --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code>FormData.keys()</code> renvoie une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés contenues dans cet objet. Les clés sont des objets {{domxref("USVString")}}.</p> +La méthode `FormData.keys()` renvoie une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés contenues dans cet objet. Les clés sont des objets {{domxref("USVString")}}. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">formData.keys();</pre> + formData.keys(); -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Retourne une {{jsxref("Les_protocoles_iteration", "itération")}}.</p> +Retourne une {{jsxref("Les_protocoles_iteration", "itération")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Créer un object FormData test +```js +// Créer un object FormData test var formData = new FormData(); formData.append('cle1', 'valeur1'); formData.append('cle2', 'valeur2'); @@ -39,41 +38,26 @@ formData.append('cle2', 'valeur2'); for (var key of formData.keys()) { console.log(key); } -</pre> +``` -<p>Le résultat est :</p> +Le résultat est : -<pre>cle1 -cle2</pre> + cle1 + cle2 -<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','#dom-formdata','keys() (as iterator<>)')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('XMLHttpRequest','#dom-formdata','keys() (as iterator<>)')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.keys")}} +## Voir aussi -<p>{{Compat("api.FormData.keys")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/FormData/Utilisation_objets_FormData">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/set/index.md b/files/fr/web/api/formdata/set/index.md index 2174a28c4d..3df31fa9a8 100644 --- a/files/fr/web/api/formdata/set/index.md +++ b/files/fr/web/api/formdata/set/index.md @@ -11,82 +11,69 @@ tags: - set translation_of: Web/API/FormData/set --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code>set()</code> de l'interface {{domxref("FormData")}} 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.</p> +La méthode `set()` de l'interface {{domxref("FormData")}} définit une nouvelle valeur pour une clé existante dans un objet `FormData`, ou ajoute la clé/valeur si elle n'existe pas encore. -<p>La différence entre <code>set()</code> et {{domxref("FormData.append")}} est que si la clé spécifiée existe déjà, <code>set()</code> écrasera toutes les valeurs existantes avec la nouvelle, tandis que {{domxref("FormData.append")}} ajoutera la nouvelle valeur à la fin de l'ensemble de valeurs existant.</p> +La différence entre `set()` et {{domxref("FormData.append")}} est que si la clé spécifiée existe déjà, `set()` écrasera toutes les valeurs existantes avec la nouvelle, tandis que {{domxref("FormData.append")}} ajoutera la nouvelle valeur à la fin de l'ensemble de valeurs existant. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API" rel="noopener">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<p>Il existe deux versions de cette méthode : une version à deux et une version à trois paramètres :</p> +Il existe deux versions de cette méthode : une version à deux et une version à trois paramètres : -<pre class="brush: js">formData.set(name, value); -formData.set(name, value, filename);</pre> +```js +formData.set(name, value); +formData.set(name, value, filename); +``` -<h4 id="append_Parameters">Paramètres</h4> +#### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Le nom du champ dont les données sont contenues en valeur (<code>value</code>).</dd> - <dt><code>value</code></dt> - <dd>La valeur du champ. Il peut s'agir d'un {{domxref("USVString")}} ou d'un {{domxref("Blob")}} (y compris les sous-classes telles que {{domxref("File")}}). Si aucune de ces sous-classes n'est spécifiée, la valeur est convertie en une chaîne de caractères.</dd> - <dt><code>filename </code>{{optional_inline}}</dt> - <dd>Le nom de fichier communiqué au serveur (un {{domxref("USVString")}}), lorsqu'un {{domxref("Blob")}} ou un {{domxref("File")}} est passée comme deuxième paramètre. Le nom de fichier par défaut pour les objets {{domxref("Blob")}} est "blob". Le nom de fichier par défaut pour les objets {{domxref("File")}} est le nom du fichier.</dd> -</dl> +- `name` + - : Le nom du champ dont les données sont contenues en valeur (`value`). +- `value` + - : La valeur du champ. Il peut s'agir d'un {{domxref("USVString")}} ou d'un {{domxref("Blob")}} (y compris les sous-classes telles que {{domxref("File")}}). Si aucune de ces sous-classes n'est spécifiée, la valeur est convertie en une chaîne de caractères. +- `filename `{{optional_inline}} + - : Le nom de fichier communiqué au serveur (un {{domxref("USVString")}}), lorsqu'un {{domxref("Blob")}} ou un {{domxref("File")}} est passée comme deuxième paramètre. Le nom de fichier par défaut pour les objets {{domxref("Blob")}} est "blob". Le nom de fichier par défaut pour les objets {{domxref("File")}} est le nom du fichier. -<div class="note"> -<p><strong>Note :</strong> Si vous spécifiez un {{domxref("Blob")}} comme donnée à ajouter à l'objet FormData, le nom du fichier qui sera rapporté au serveur dans l'en-tête "Content-Disposition" utilisé pour varier d'un navigateur à l'autre.</p> -</div> +> **Note :** Si vous spécifiez un {{domxref("Blob")}} comme donnée à ajouter à l'objet FormData, le nom du fichier qui sera rapporté au serveur dans l'en-tête "Content-Disposition" utilisé pour varier d'un navigateur à l'autre. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>La ligne suivante crée un objet <code>FormData</code> vide:</p> +La ligne suivante crée un objet `FormData` vide: -<pre class="brush: js">var formData = new FormData(); // Actuellement vide</pre> +```js +var formData = new FormData(); // Actuellement vide +``` -<p>Vous pouvez définir des paires clé/valeur à ce sujet en utilisant {{domxref("FormData.set")}} :</p> +Vous pouvez définir des paires clé/valeur à ce sujet en utilisant {{domxref("FormData.set")}} : -<pre class="brush: js">formData.set('username', 'Chris'); -formData.set('userpic', myFileInput.files[0], 'chris.jpg');</pre> +```js +formData.set('username', 'Chris'); +formData.set('userpic', myFileInput.files[0], 'chris.jpg'); +``` -<p>Si la valeur envoyée est différente de String ou Blob, elle sera automatiquement convertie en <code>String</code> :</p> +Si la valeur envoyée est différente de String ou Blob, elle sera automatiquement convertie en `String` : -<pre class="brush: js">formData.set('name', 72); -formData.get('name'); // "72"</pre> +```js +formData.set('name', 72); +formData.get('name'); // "72" +``` -<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','#dom-formdata-set','set()')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}} | {{Spec2('XMLHttpRequest')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.set")}} +## Voir aussi -<p>{{Compat("api.FormData.set")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/Guide/Using_FormData_Objects">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/Guide/Using_FormData_Objects) +- {{HTMLElement("Form")}} diff --git a/files/fr/web/api/formdata/using_formdata_objects/index.md b/files/fr/web/api/formdata/using_formdata_objects/index.md index 93fc4bc977..480822832a 100644 --- a/files/fr/web/api/formdata/using_formdata_objects/index.md +++ b/files/fr/web/api/formdata/using_formdata_objects/index.md @@ -12,13 +12,14 @@ tags: translation_of: Web/API/FormData/Using_FormData_Objects original_slug: Web/API/FormData/Utilisation_objets_FormData --- -<p>L’objet <code><a href="/en-US/docs/Web/API/FormData">FormData</a></code> vous permet de compiler un ensemble de paires clé/valeur à envoyer à l’aide de l’API <code><a href="/en-US/docs/Web/API/XMLHttpRequest">XMLHttpRequest</a></code>. Il est principalement destiné à l’envoi de données de formulaire, mais il peut également être utilisé indépendamment des formulaires pour transmettre des données indexées. Le format des données transmises est le même que celui qu’utiliserait la méthode {{domxref("HTMLFormElement.submit","submit()")}} du formulaire pour envoyer les données si l’encodage de ce dernier était défini sur <code>multipart/form-data</code>.</p> +L’objet [`FormData`](/en-US/docs/Web/API/FormData) vous permet de compiler un ensemble de paires clé/valeur à envoyer à l’aide de l’API [`XMLHttpRequest`](/en-US/docs/Web/API/XMLHttpRequest). Il est principalement destiné à l’envoi de données de formulaire, mais il peut également être utilisé indépendamment des formulaires pour transmettre des données indexées. Le format des données transmises est le même que celui qu’utiliserait la méthode {{domxref("HTMLFormElement.submit","submit()")}} du formulaire pour envoyer les données si l’encodage de ce dernier était défini sur `multipart/form-data`. -<h2 id="Création_intégrale_d’un_objet_FormData">Création intégrale d’un objet FormData</h2> +## Création intégrale d’un objet FormData -<p>Vous pouvez construire un objet <code>FormData</code> vous-même, en créer une instance, puis y ajouter des champs en appelant la méthode {{domxref("FormData.append","append()")}}, comme suit :</p> +Vous pouvez construire un objet `FormData` vous-même, en créer une instance, puis y ajouter des champs en appelant la méthode {{domxref("FormData.append","append()")}}, comme suit : -<pre class="brush: js">var formData = new FormData(); +```js +var formData = new FormData(); formData.append("username", "Groucho"); formData.append("accountnum", 123456); // le numéro 123456 est converti immédiatement en chaîne "123456" @@ -27,7 +28,7 @@ formData.append("accountnum", 123456); // le numéro 123456 est converti immédi formData.append("userfile", fileInputElement.files[0]); // objet JavaScript de type fichier -var content = '<a id="a"><b id="b">hey!</b></a>'; // the body of the new file... +var content = '<a id="a"><b id="b">hey!</b></a>'; // the body of the new file... var blob = new Blob([content], { type: "text/xml"}); formData.append("webmasterfile", blob); @@ -35,59 +36,63 @@ formData.append("webmasterfile", blob); var request = new XMLHttpRequest(); request.open("POST", "http://foo.com/submitform.php"); request.send(formData); -</pre> +``` -<div class="note"> - <p><strong>Note :</strong> Les champs « userfile » et « webmasterfile » contiennent tous deux un fichier. Le numéro attribué au champ « accountnum » est immédiatement converti en chaîne par la méthode <a href="/en/DOM/XMLHttpRequest/FormData#append()"><code>FormData.append()</code></a> (la valeur du champ peut être un objet {{ domxref("Blob") }}, {{ domxref("File") }} ou une chaîne : <strong>s’il ne s’agit ni d’un objet Blob, ni d’un objet File, la valeur est convertie en chaîne</strong>).</p> -</div> +> **Note :** Les champs « userfile » et « webmasterfile » contiennent tous deux un fichier. Le numéro attribué au champ « accountnum » est immédiatement converti en chaîne par la méthode [`FormData.append()`](</en/DOM/XMLHttpRequest/FormData#append()>) (la valeur du champ peut être un objet {{ domxref("Blob") }}, {{ domxref("File") }} ou une chaîne : **s’il ne s’agit ni d’un objet Blob, ni d’un objet File, la valeur est convertie en chaîne**). -<p>Dans cet exemple, une instance <code>FormData</code> contenant les valeurs des champs « username », « accountnum », « userfile » et « webmasterfile » est créée, puis la méthode <code>XMLHttpRequest</code> <a href="/en/DOM/XMLHttpRequest#send()"><code>send()</code></a> est utilisée pour envoyer les données du formulaire. Le champ « webmasterfile » est un objet {{domxref("Blob")}}. Un objet <code>Blob</code> représente un objet-fichier de données brutes immuables. Les Blobs représentent des données qui ne sont pas nécessairement dans un format JavaScript natif. L’interface {{ domxref("File") }} se base sur l’objet <code>Blob</code>, elle en hérite les fonctionnalités et les étend pour prendre en charge les fichiers du système de l’utilisateur. Pour construire un <code>Blob</code>, vous pouvez invoquer le {{domxref("Blob.Blob","constructeur Blob()")}}.</p> +Dans cet exemple, une instance `FormData` contenant les valeurs des champs « username », « accountnum », « userfile » et « webmasterfile » est créée, puis la méthode `XMLHttpRequest` [`send()`](</en/DOM/XMLHttpRequest#send()>) est utilisée pour envoyer les données du formulaire. Le champ « webmasterfile » est un objet {{domxref("Blob")}}. Un objet `Blob` représente un objet-fichier de données brutes immuables. Les Blobs représentent des données qui ne sont pas nécessairement dans un format JavaScript natif. L’interface {{ domxref("File") }} se base sur l’objet `Blob`, elle en hérite les fonctionnalités et les étend pour prendre en charge les fichiers du système de l’utilisateur. Pour construire un `Blob`, vous pouvez invoquer le {{domxref("Blob.Blob","constructeur Blob()")}}. -<h2 id="Récupération_d’un_objet_FormData_dans_un_formulaire_HTML">Récupération d’un objet FormData dans un formulaire HTML</h2> +## Récupération d’un objet FormData dans un formulaire HTML -<p>Pour construire un objet <code>FormData</code> contenant les données d’un élément HTML {{ HTMLElement("form") }} existant, spécifiez cet élément lors de la création de l’objet<code> </code>:</p> +Pour construire un objet `FormData` contenant les données d’un élément HTML {{ HTMLElement("form") }} existant, spécifiez cet élément lors de la création de l’objet` `: -<pre class="brush: js">var formData = new FormData(someFormElement); -</pre> +```js +var formData = new FormData(someFormElement); +``` -<p>Par exemple :</p> +Par exemple : -<pre class="brush: js">var formElement = document.querySelector("form"); +```js +var formElement = document.querySelector("form"); var request = new XMLHttpRequest(); request.open("POST", "submitform.php"); request.send(new FormData(formElement)); -</pre> +``` -<p>Vous pouvez également ajouter des données supplémentaires à l’objet <code>FormData</code> entre sa récupération dans un formulaire et son envoi, comme suit :</p> +Vous pouvez également ajouter des données supplémentaires à l’objet `FormData` entre sa récupération dans un formulaire et son envoi, comme suit : -<pre class="brush: js">var formElement = document.querySelector("form"); +```js +var formElement = document.querySelector("form"); var formData = new FormData(formElement); var request = new XMLHttpRequest(); request.open("POST", "submitform.php"); formData.append("serialnumber", serialNumber++); -request.send(formData);</pre> +request.send(formData); +``` -<p>Vous pouvez ainsi ajouter des données au formulaire avant de l’envoyer, pour y inclure des informations supplémentaires que les utilisateurs ne peuvent pas nécessairement modifier.</p> +Vous pouvez ainsi ajouter des données au formulaire avant de l’envoyer, pour y inclure des informations supplémentaires que les utilisateurs ne peuvent pas nécessairement modifier. -<h2 id="Envoi_de_fichiers_via_un_objet_FormData">Envoi de fichiers via un objet FormData</h2> +## Envoi de fichiers via un objet FormData -<p>L’objet <code>FormData</code> vous permet également d’envoyer des fichiers. Il vous suffit d’inclure un élément HTML {{ HTMLElement("input") }} de type <code>file</code> dans votre élément {{htmlelement("form")}} :</p> +L’objet `FormData` vous permet également d’envoyer des fichiers. Il vous suffit d’inclure un élément HTML {{ HTMLElement("input") }} de type `file` dans votre élément {{htmlelement("form")}} : -<pre class="brush: html"><form enctype="multipart/form-data" method="post" name="fileinfo"> - <label>Votre adresse électronique :</label> - <input type="email" autocomplete="on" autofocus name="userid" placeholder="email" required size="32" maxlength="64" /><br /> - <label>Étiquette du fichier personnalisé :</label> - <input type="text" name="filelabel" size="12" maxlength="32" /><br /> - <label>Fichier à mettre de côté :</label> - <input type="file" name="file" required /> - <input type="submit" value="Mettez le fichier de côté." /> -</form> -<div></div> -</pre> +```html +<form enctype="multipart/form-data" method="post" name="fileinfo"> + <label>Votre adresse électronique :</label> + <input type="email" autocomplete="on" autofocus name="userid" placeholder="email" required size="32" maxlength="64" /><br /> + <label>Étiquette du fichier personnalisé :</label> + <input type="text" name="filelabel" size="12" maxlength="32" /><br /> + <label>Fichier à mettre de côté :</label> + <input type="file" name="file" required /> + <input type="submit" value="Mettez le fichier de côté." /> +</form> +<div></div> +``` -<p>Vous pouvez ensuite l’envoyer à l’aide du code suivant :</p> +Vous pouvez ensuite l’envoyer à l’aide du code suivant : -<pre class="brush: js">var form = document.forms.namedItem("fileinfo"); +```js +var form = document.forms.namedItem("fileinfo"); form.addEventListener('submit', function(ev) { var oOutput = document.querySelector("div"), @@ -101,29 +106,29 @@ form.addEventListener('submit', function(ev) { if (oReq.status == 200) { oOutput.innerHTML = "Envoyé !"; } else { - oOutput.innerHTML = "Erreur " + oReq.status + " lors de la tentative d’envoi du fichier.<br \/>"; + oOutput.innerHTML = "Erreur " + oReq.status + " lors de la tentative d’envoi du fichier.<br \/>"; } }; oReq.send(oData); ev.preventDefault(); }, false); -</pre> +``` -<div class="note"> -<p><strong>Note :</strong> Si vous passez une référence dans le formulaire, la méthode spécifiée dans ce dernier sera utilisée au lieu de celle définie dans l’appel de la méthode open().</p> -</div> +> **Note :** Si vous passez une référence dans le formulaire, la méthode spécifiée dans ce dernier sera utilisée au lieu de celle définie dans l’appel de la méthode open(). -<p>Vous pouvez également ajouter un objet {{ domxref("File") }} ou {{ domxref("Blob") }} directement dans l’objet {{ domxref("FormData") }} :</p> +Vous pouvez également ajouter un objet {{ domxref("File") }} ou {{ domxref("Blob") }} directement dans l’objet {{ domxref("FormData") }} : -<pre class="brush: js">data.append("myfile", myBlob, "filename.txt"); -</pre> +```js +data.append("myfile", myBlob, "filename.txt"); +``` -<p>Avec la méthode {{domxref("FormData.append","append()")}}, vous pouvez utiliser le troisième paramètre facultatif pour passer un nom de fichier dans l’en-tête <code>Content-Disposition</code> envoyé au serveur. Si aucun nom de fichier n’est spécifié (ou si le paramètre n’est pas pris en charge), le nom « blob » est utilisé.</p> +Avec la méthode {{domxref("FormData.append","append()")}}, vous pouvez utiliser le troisième paramètre facultatif pour passer un nom de fichier dans l’en-tête `Content-Disposition` envoyé au serveur. Si aucun nom de fichier n’est spécifié (ou si le paramètre n’est pas pris en charge), le nom « blob » est utilisé. -<p>Vous pouvez utiliser l’objet <code>FormData</code> avec jQuery si vous définissez les options appropriées :</p> +Vous pouvez utiliser l’objet `FormData` avec jQuery si vous définissez les options appropriées : -<pre class="brush: js">var fd = new FormData(document.querySelector("form")); +```js +var fd = new FormData(document.querySelector("form")); fd.append("CustomField", "Données supplémentaires"); $.ajax({ url: "stash.php", @@ -132,17 +137,15 @@ $.ajax({ processData: false, // dire à jQuery de ne pas traiter les données contentType: false // dire à jQuery de ne pas définir le contentType }); -</pre> +``` -<h2 id="Envoi_de_formulaires_et_de_fichiers_via_AJAX_sans_objet_FormData">Envoi de formulaires et de fichiers via AJAX <em>sans</em> objet <code>FormData</code></h2> +## Envoi de formulaires et de fichiers via AJAX *sans* objet `FormData` -<p>Si vous voulez en savoir plus sur la sérialisation des données et l’envoi d’un formulaire via <a href="/en-US/docs/AJAX">AJAX</a> <em>sans</em> utiliser d’objets FormData, consultez <a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Submitting_forms_and_uploading_files">ce paragraph</a>e.</p> +Si vous voulez en savoir plus sur la sérialisation des données et l’envoi d’un formulaire via [AJAX](/en-US/docs/AJAX) *sans* utiliser d’objets FormData, consultez [ce paragraph](/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Submitting_forms_and_uploading_files)e. -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li>{{domxref("HTMLFormElement")}}</li> - <li>{{domxref("Blob")}}</li> - <li><a href="/en-US/docs/Web/JavaScript/Typed_arrays">Tableaux typés</a></li> -</ul> +- [Utiliser XMLHttpRequest](/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- {{domxref("HTMLFormElement")}} +- {{domxref("Blob")}} +- [Tableaux typés](/en-US/docs/Web/JavaScript/Typed_arrays) diff --git a/files/fr/web/api/formdata/values/index.md b/files/fr/web/api/formdata/values/index.md index 7a5ddadcec..5d9b46fc27 100644 --- a/files/fr/web/api/formdata/values/index.md +++ b/files/fr/web/api/formdata/values/index.md @@ -12,25 +12,24 @@ tags: - values translation_of: Web/API/FormData/values --- -<p>{{APIRef("XMLHttpRequest")}}</p> +{{APIRef("XMLHttpRequest")}} -<p>La méthode <code><strong>FormData.values()</strong></code> renvoie une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de passer en revue toutes les valeurs contenues dans cet objet. Les valeurs sont des objets {{domxref("USVString")}} ou {{domxref("Blob")}}.</p> +La méthode **`FormData.values()`** renvoie une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de passer en revue toutes les valeurs contenues dans cet objet. Les valeurs sont des objets {{domxref("USVString")}} ou {{domxref("Blob")}}. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est disponible dans les <a href="/fr/docs/Web/API/Web_Workers_API" rel="noopener">Web Workers</a>.</p> -</div> +> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">formData.values();</pre> + formData.values(); -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} .</p> +Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} . -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Créer un objet FormData test +```js +// Créer un objet FormData test var formData = new FormData(); formData.append('cle1', 'valeur1'); formData.append('cle2', 'valeur2'); @@ -39,41 +38,26 @@ formData.append('cle2', 'valeur2'); for (var value of formData.values()) { console.log(value); } -</pre> +``` -<p>Le résultat est :</p> +Le résultat est : -<pre>valeur1 -valeur2</pre> + valeur1 + valeur2 -<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','#dom-formdata','values() (as iterator<>)')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('XMLHttpRequest','#dom-formdata','values() (as iterator<>)')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.FormData.values")}} +## Voir aussi -<p>{{Compat("api.FormData.values")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("XMLHTTPRequest")}}</li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest">Utiliser XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/Guide/Using_FormData_Objects">Utiliser les objets FormData</a></li> - <li>{{HTMLElement("Form")}}</li> -</ul> +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/Guide/Using_FormData_Objects) +- {{HTMLElement("Form")}} |