aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/htmloptionelement
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/htmloptionelement
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/htmloptionelement')
-rw-r--r--files/fr/web/api/htmloptionelement/index.md220
-rw-r--r--files/fr/web/api/htmloptionelement/option/index.md94
2 files changed, 171 insertions, 143 deletions
diff --git a/files/fr/web/api/htmloptionelement/index.md b/files/fr/web/api/htmloptionelement/index.md
index b1294570c6..659bee7a16 100644
--- a/files/fr/web/api/htmloptionelement/index.md
+++ b/files/fr/web/api/htmloptionelement/index.md
@@ -9,92 +9,117 @@ tags:
- Reference
translation_of: Web/API/HTMLOptionElement
---
-<div>{{APIRef("HTML DOM")}}</div>
+{{APIRef("HTML DOM")}}
-<p>L'interface <code>HTMLOptionElement</code> représente l'élément {{HTMLElement("option")}} et hérite de toutes les classes et méthodes de l'intreface {{domxref("HTMLElement")}} .</p>
+L'interface `HTMLOptionElement` représente l'élément {{HTMLElement("option")}} et hérite de toutes les classes et méthodes de l'intreface {{domxref("HTMLElement")}} .
-<h2 id="Properties"><em>Propriétés</em></h2>
+## _Propriétés_
+
+_hérite des propriétés de son parent, {{domxref("HTMLElement")}}._
-<p><em>hérite des propriétés de son parent, {{domxref("HTMLElement")}}.</em></p>
<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Nom</th>
- <th scope="col">Type</th>
- <th scope="col">Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>defaultSelected</code></td>
- <td>{{domxref("Boolean")}}</td>
- <td>
- <p>Contient la valeur initiale de l'attribut HTML {{htmlattrxref("selected", "option")}} ,indiquant si l'option est sélectionnée par défaut ou non.</p>
- </td>
- </tr>
- <tr>
- <td><code>disabled</code></td>
- <td>{{domxref("Boolean")}}</td>
- <td>
- <p>Retourne la valeur de l'attribut HTML {{htmlattrxref("disabled", "option")}} , cet attribut indique que l'option ne peut pas être sélectionnée. Une option peut aussi être désactivée lorsqu'elle est fille d'un élément {{HTMLElement("optgroup")}} désactivé.</p>
- </td>
- </tr>
- <tr>
- <td><code>form</code>{{readonlyInline}}</td>
- <td>{{domxref("HTMLFormElement")}}</td>
- <td>
- <p>Si l'option est une fille d'un élément {{HTMLElement("select")}}, cette propriété à la même valeur que l'attribut <code>form</code> de l'objet {{DomXref("HTMLSelectElement")}}</p>
- <p>correspondant, sinon , sa valeur est <code>null</code>.</p>
- </td>
- </tr>
- <tr>
- <td><code>index</code>{{readonlyInline}}</td>
- <td><code>long</code></td>
- <td>
- <p>La position de l'option dans la liste d'options à laquelle elle appartient, dans un ordre arborescent. Si l'option ne fait pas partie d'une liste d'options , comme dans le cas où elle appartient à l'élément {{HTMLElement("datalist")}} sa valeur est 0.</p>
- </td>
- </tr>
- <tr>
- <td><code>label</code></td>
- <td>{{domxref("DOMString")}}</td>
- <td>
- <p>Reflète la valeur de l'attribut {{htmlattrxref("label", "option")}}, qui fourni un libellé à l'option. si cet attribut n'est pas spécifié, sa lecture retourne le text de l'élément en question.</p>
- </td>
- </tr>
- <tr>
- <td><code>selected</code></td>
- <td>{{domxref("Boolean")}}</td>
- <td>
- <p>Indique si l'option est sélectionnée ou non .</p>
- </td>
- </tr>
- <tr>
- <td><code>text</code></td>
- <td>{{domxref("DOMString")}}</td>
- <td>
- <p>Contient le contenu texte de l'élément.</p>
- </td>
- </tr>
- <tr>
- <td><code>value</code></td>
- <td>{{domxref("DOMString")}}</td>
- <td>
- <p>Retourne la valeur de l'attribut HTML {{htmlattrxref("value", "option")}}, s'il existe, sinon la valeur de la propriété {{domxref("Node.textContent")}} est retournée.</p>
- </td>
- </tr>
- </tbody>
+ <thead>
+ <tr>
+ <th scope="col">Nom</th>
+ <th scope="col">Type</th>
+ <th scope="col">Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code>defaultSelected</code></td>
+ <td>{{domxref("Boolean")}}</td>
+ <td>
+ <p>
+ Contient la valeur initiale de l'attribut HTML
+ {{htmlattrxref("selected", "option")}} ,indiquant si
+ l'option est sélectionnée par défaut ou non.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>disabled</code></td>
+ <td>{{domxref("Boolean")}}</td>
+ <td>
+ <p>
+ Retourne la valeur de l'attribut HTML
+ {{htmlattrxref("disabled", "option")}} , cet attribut
+ indique que l'option ne peut pas être sélectionnée. Une option peut
+ aussi être désactivée lorsqu'elle est fille d'un élément
+ {{HTMLElement("optgroup")}} désactivé.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>form</code>{{readonlyInline}}</td>
+ <td>{{domxref("HTMLFormElement")}}</td>
+ <td>
+ <p>
+ Si l'option est une fille d'un élément
+ {{HTMLElement("select")}}, cette propriété à la même valeur que
+ l'attribut <code>form</code> de l'objet
+ {{DomXref("HTMLSelectElement")}}
+ </p>
+ <p>correspondant, sinon , sa valeur est <code>null</code>.</p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>index</code>{{readonlyInline}}</td>
+ <td><code>long</code></td>
+ <td>
+ <p>
+ La position de l'option dans la liste d'options à laquelle elle
+ appartient, dans un ordre arborescent. Si l'option ne fait pas partie
+ d'une liste d'options , comme dans le cas où elle appartient à
+ l'élément {{HTMLElement("datalist")}} sa valeur est 0.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>label</code></td>
+ <td>{{domxref("DOMString")}}</td>
+ <td>
+ <p>
+ Reflète la valeur de l'attribut
+ {{htmlattrxref("label", "option")}}, qui fourni un
+ libellé à l'option. si cet attribut n'est pas spécifié, sa lecture
+ retourne le text de l'élément en question.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>selected</code></td>
+ <td>{{domxref("Boolean")}}</td>
+ <td><p>Indique si l'option est sélectionnée ou non .</p></td>
+ </tr>
+ <tr>
+ <td><code>text</code></td>
+ <td>{{domxref("DOMString")}}</td>
+ <td><p>Contient le contenu texte de l'élément.</p></td>
+ </tr>
+ <tr>
+ <td><code>value</code></td>
+ <td>{{domxref("DOMString")}}</td>
+ <td>
+ <p>
+ Retourne la valeur de l'attribut HTML
+ {{htmlattrxref("value", "option")}}, s'il existe, sinon
+ la valeur de la propriété {{domxref("Node.textContent")}} est
+ retournée.
+ </p>
+ </td>
+ </tr>
+ </tbody>
</table>
-<h2 id="Methods">Méthodes</h2>
+## Méthodes
-<p><em>Hérite des méthodes de son parent , {{domxref("HTMLElement")}}.</em></p>
+_Hérite des méthodes de son parent , {{domxref("HTMLElement")}}._
-<dl>
- <dt>{{domxref("HTMLOptionElement.Option()")}}</dt>
- <dd><p>C'est le constructeur créant l'objet <code>HTMLOptionElement</code> object. il accepte quatre valeurs : le texte à afficher , <code>text</code>, la valeur associée au texte , <code>value</code>, la valeur du <code>defaultSelected</code>, et la valeur du <code>selected</code>. les trois dernières sont optionnelles.</p></dd>
-</dl>
+- {{domxref("HTMLOptionElement.Option()")}}
+ - : C'est le constructeur créant l'objet `HTMLOptionElement` object. il accepte quatre valeurs : le texte à afficher , `text`, la valeur associée au texte , `value`, la valeur du `defaultSelected`, et la valeur du `selected`. les trois dernières sont optionnelles.
-<h2 id="Specifications">Spécifications</h2>
+## Spécifications
<table class="standard-table">
<thead>
@@ -106,41 +131,56 @@ translation_of: Web/API/HTMLOptionElement
</thead>
<tbody>
<tr>
- <td>{{SpecName('HTML WHATWG', "the-button-element.html#the-option-element", "HTMLOptionElement")}}</td>
+ <td>
+ {{SpecName('HTML WHATWG', "the-button-element.html#the-option-element", "HTMLOptionElement")}}
+ </td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>
<p>pas de changement depuis la {{SpecName("HTML5 W3C")}}.</p>
</td>
</tr>
<tr>
- <td>{{SpecName('HTML5 W3C', "forms.html#the-option-element", "HTMLOptionElement")}}</td>
+ <td>
+ {{SpecName('HTML5 W3C', "forms.html#the-option-element", "HTMLOptionElement")}}
+ </td>
<td>{{Spec2('HTML5 W3C')}}</td>
<td>
- <p>Le constructeur, <code>Option()</code>, a été ajouté. la propriété <code>form </code>peut avoir la valeur <code>null</code>.</p>
+ <p>
+ Le constructeur, <code>Option()</code>, a été ajouté. la propriété
+ <code>form </code>peut avoir la valeur <code>null</code>.
+ </p>
</td>
</tr>
<tr>
- <td>{{SpecName('DOM2 HTML', 'html.html#ID-70901257', 'HTMLOptionElement')}}</td>
+ <td>
+ {{SpecName('DOM2 HTML', 'html.html#ID-70901257', 'HTMLOptionElement')}}
+ </td>
<td>{{Spec2('DOM2 HTML')}}</td>
<td>
- <p>Le sens de la propriété <code>selected a changé</code>: elle indique désormais si l'option est sélectionnée à l'instant , au lieu d'indiquer si elle a été initialement sélectionnée.</p>
- <p>La propriété <code>defaultSelected</code> n'est plus en lecture seule</p>
+ <p>
+ Le sens de la propriété <code>selected a changé</code>: elle indique
+ désormais si l'option est sélectionnée à l'instant , au lieu
+ d'indiquer si elle a été initialement sélectionnée.
+ </p>
+ <p>
+ La propriété <code>defaultSelected</code> n'est plus en lecture seule
+ </p>
</td>
</tr>
<tr>
- <td>{{SpecName('DOM1', 'level-one-html.html#ID-70901257', 'HTMLOptionElement')}}</td>
+ <td>
+ {{SpecName('DOM1', 'level-one-html.html#ID-70901257', 'HTMLOptionElement')}}
+ </td>
<td>{{Spec2('DOM1')}}</td>
<td>La définition initiale .</td>
</tr>
</tbody>
</table>
-<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
+## Compatibilité des navigateurs
-<p>{{Compat("api.HTMLOptionElement")}}</p>
+{{Compat("api.HTMLOptionElement")}}
-<h2 id="See_also">Voir aussi</h2>
+## Voir aussi
-<ul>
- <li>L'élément HTML qui implémente cette interface : {{ HTMLElement("option") }}.</li>
-</ul>
+- L'élément HTML qui implémente cette interface : {{ HTMLElement("option") }}.
diff --git a/files/fr/web/api/htmloptionelement/option/index.md b/files/fr/web/api/htmloptionelement/option/index.md
index 975d2cc634..70ed813c2d 100644
--- a/files/fr/web/api/htmloptionelement/option/index.md
+++ b/files/fr/web/api/htmloptionelement/option/index.md
@@ -8,35 +8,34 @@ tags:
- HTMLOptionElement
translation_of: Web/API/HTMLOptionElement/Option
---
-<div>{{APIRef("HTML DOM")}}</div>
+{{APIRef("HTML DOM")}}
-<p>Le constructeur <strong><code>Option()</code></strong> permet de créer un nouvel objet {{domxref("HTMLOptionElement")}}.</p>
+Le constructeur **`Option()`** permet de créer un nouvel objet {{domxref("HTMLOptionElement")}}.
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
-<pre class="syntaxbox">var <em>o</em><em>ptionElementReference</em> = new Option(<em>text</em>, <em>value</em>, <em>defaultSelected</em>, <em>selected</em>);</pre>
+ var optionElementReference = new Option(text, value, defaultSelected, selected);
-<h3 id="Parameters">Parameters</h3>
+### Parameters
-<dl>
- <dt><code>text</code> {{optional_inline}}</dt>
- <dd>Une chaîne de caractères {{domxref("DOMString")}} représentant le contenu de l'élément, c'est-à-dire le texte affiché. Si cet argument n'est pas spécifié, c'est la chaîne vide qui sera utilisée.</dd>
- <dt><code>value</code> {{optional_inline}}</dt>
- <dd>Une chaîne de caractères {{domxref("DOMString")}} représentant la valeur de {{domxref("HTMLOptionElement")}}, c’est-à-dire l’attribut HTML <code>value</code> de l'élément {{htmlelement("option")}}. Si cet argument n'est pas fourni, ce sera la valeur de <code>text</code> qui sera reprise comme valeur (par exemple pour l'élément {{htmlelement("select")}} associé lorsque le formulaire est envoyé au serveur).</dd>
- <dt><code>defaultSelected</code> {{optional_inline}}</dt>
- <dd>Un {{domxref("Boolean")}} qui définit la valeur de l'attribut {{htmlattrxref("selected", "option")}}, c'est-à-dire que cette {{htmlelement("option")}} sera la valeur par défaut sélectionné dans l'élément {{htmlelement("select")}} lors du premier chargement de la page. S'il n'est pas spécifié, la valeur <code>false</code> sera utilisée par défaut.</dd>
- <dt><code>selected</code> {{optional_inline}}</dt>
- <dd>Un {{domxref("Boolean")}} qui définit l'état sélectionné de l'option, la valeur par défaut est <code>false</code> (non sélectionné). Si cet argument est absent et même si l'argument <code>defaultSelected</code> vaut <code>true</code>, l'option ne sera pas pas sélectionnée.</dd>
-</dl>
+- `text` {{optional_inline}}
+ - : Une chaîne de caractères {{domxref("DOMString")}} représentant le contenu de l'élément, c'est-à-dire le texte affiché. Si cet argument n'est pas spécifié, c'est la chaîne vide qui sera utilisée.
+- `value` {{optional_inline}}
+ - : Une chaîne de caractères {{domxref("DOMString")}} représentant la valeur de {{domxref("HTMLOptionElement")}}, c’est-à-dire l’attribut HTML `value` de l'élément {{htmlelement("option")}}. Si cet argument n'est pas fourni, ce sera la valeur de `text` qui sera reprise comme valeur (par exemple pour l'élément {{htmlelement("select")}} associé lorsque le formulaire est envoyé au serveur).
+- `defaultSelected` {{optional_inline}}
+ - : Un {{domxref("Boolean")}} qui définit la valeur de l'attribut {{htmlattrxref("selected", "option")}}, c'est-à-dire que cette {{htmlelement("option")}} sera la valeur par défaut sélectionné dans l'élément {{htmlelement("select")}} lors du premier chargement de la page. S'il n'est pas spécifié, la valeur `false` sera utilisée par défaut.
+- `selected` {{optional_inline}}
+ - : Un {{domxref("Boolean")}} qui définit l'état sélectionné de l'option, la valeur par défaut est `false` (non sélectionné). Si cet argument est absent et même si l'argument `defaultSelected` vaut `true`, l'option ne sera pas pas sélectionnée.
-<h2 id="Exemples">Exemples</h2>
+## Exemples
-<h3 id="Ajouter_de_nouvelles_options">Ajouter de nouvelles options</h3>
+### Ajouter de nouvelles options
-<pre class="brush: js">/* Imaginons qu'on ait le code HTML suivant dans le document
-&lt;select id='s'&gt;
+```js
+/* Imaginons qu'on ait le code HTML suivant dans le document
+<select id='s'>
-&lt;/select&gt;
+</select>
*/
var s = document.getElementById('s');
@@ -45,16 +44,17 @@ var options = [Quatre, Cinq, Six];
options.forEach(function(element,key) {
s[key] = new Option(element,key);
});
-</pre>
+```
-<h3 id="Ajouter_des_options_avec_différents_paramètres">Ajouter des options avec différents paramètres</h3>
+### Ajouter des options avec différents paramètres
-<pre class="brush: js">/* Imaginons qu'ont ait le code HTML suivant dans le document
-&lt;select id="s"&gt;
- &lt;option&gt;Premier&lt;/option&gt;
- &lt;option&gt;Deuxième&lt;/option&gt;
- &lt;option&gt;Troisième&lt;/option&gt;
-&lt;/select&gt;
+```js
+/* Imaginons qu'ont ait le code HTML suivant dans le document
+<select id="s">
+ <option>Premier</option>
+ <option>Deuxième</option>
+ <option>Troisième</option>
+</select>
*/
var s = document.getElementById('s');
@@ -73,28 +73,16 @@ options.forEach(function(element, key) {
});
/* Résultat dans le DOM / HTML modifié :
-&lt;select id="s"&gt;
- &lt;option value="0"&gt;zéro&lt;/option&gt;
- &lt;option value="1" selected=""&gt;un&lt;/option&gt;
- &lt;option value="2"&gt;deux&lt;/option&gt; // L'utilisateur verra cette option sélectionnée
-&lt;/select&gt;
-*/</pre>
-
-<h2 id="Spécifications">Spécifications</h2>
-
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">État</th>
- <th scope="col">Commentaires</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a href="http://www.w3.org/TR/2012/WD-html5-20121025/the-option-element.html#dom-option">HTML5 La définition de Option dans cette spécification.</a></td>
- <td>Recommendation</td>
- <td></td>
- </tr>
- </tbody>
-</table>
+<select id="s">
+ <option value="0">zéro</option>
+ <option value="1" selected="">un</option>
+ <option value="2">deux</option> // L'utilisateur verra cette option sélectionnée
+</select>
+*/
+```
+
+## Spécifications
+
+| Spécification | État | Commentaires |
+| ----------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------ |
+| [HTML5 La définition de Option dans cette spécification.](http://www.w3.org/TR/2012/WD-html5-20121025/the-option-element.html#dom-option) | Recommendation | |