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/htmloptionelement | |
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/htmloptionelement')
-rw-r--r-- | files/fr/web/api/htmloptionelement/index.md | 220 | ||||
-rw-r--r-- | files/fr/web/api/htmloptionelement/option/index.md | 94 |
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 -<select id='s'> +```js +/* Imaginons qu'on ait le code HTML suivant dans le document +<select id='s'> -</select> +</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 -<select id="s"> - <option>Premier</option> - <option>Deuxième</option> - <option>Troisième</option> -</select> +```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é : -<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> -*/</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 | | |