From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/htmloptionelement/index.md | 220 ++++++++++++--------- files/fr/web/api/htmloptionelement/option/index.md | 94 ++++----- 2 files changed, 171 insertions(+), 143 deletions(-) (limited to 'files/fr/web/api/htmloptionelement') 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 --- -
{{APIRef("HTML DOM")}}
+{{APIRef("HTML DOM")}} -

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")}} .

+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")}} . -

Propriétés

+## _Propriétés_ + +_hérite des propriétés de son parent, {{domxref("HTMLElement")}}._ -

hérite des propriétés de son parent, {{domxref("HTMLElement")}}.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NomTypeDescription
defaultSelected{{domxref("Boolean")}} -

Contient la valeur initiale de l'attribut HTML {{htmlattrxref("selected", "option")}} ,indiquant si l'option est sélectionnée par défaut ou non.

-
disabled{{domxref("Boolean")}} -

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é.

-
form{{readonlyInline}}{{domxref("HTMLFormElement")}} -

Si l'option est une fille d'un élément {{HTMLElement("select")}}, cette propriété à la même valeur que l'attribut form de l'objet {{DomXref("HTMLSelectElement")}}

-

correspondant, sinon , sa valeur est null.

-
index{{readonlyInline}}long -

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.

-
label{{domxref("DOMString")}} -

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.

-
selected{{domxref("Boolean")}} -

Indique si l'option est sélectionnée ou non .

-
text{{domxref("DOMString")}} -

Contient le contenu texte de l'élément.

-
value{{domxref("DOMString")}} -

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.

-
NomTypeDescription
defaultSelected{{domxref("Boolean")}} +

+ Contient la valeur initiale de l'attribut HTML + {{htmlattrxref("selected", "option")}} ,indiquant si + l'option est sélectionnée par défaut ou non. +

+
disabled{{domxref("Boolean")}} +

+ 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é. +

+
form{{readonlyInline}}{{domxref("HTMLFormElement")}} +

+ Si l'option est une fille d'un élément + {{HTMLElement("select")}}, cette propriété à la même valeur que + l'attribut form de l'objet + {{DomXref("HTMLSelectElement")}} +

+

correspondant, sinon , sa valeur est null.

+
index{{readonlyInline}}long +

+ 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. +

+
label{{domxref("DOMString")}} +

+ 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. +

+
selected{{domxref("Boolean")}}

Indique si l'option est sélectionnée ou non .

text{{domxref("DOMString")}}

Contient le contenu texte de l'élément.

value{{domxref("DOMString")}} +

+ 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. +

+
-

Méthodes

+## Méthodes -

Hérite des méthodes de son parent , {{domxref("HTMLElement")}}.

+_Hérite des méthodes de son parent , {{domxref("HTMLElement")}}._ -
-
{{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.

-
+- {{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. -

Spécifications

+## Spécifications @@ -106,41 +131,56 @@ translation_of: Web/API/HTMLOptionElement - + - + - + - +
{{SpecName('HTML WHATWG', "the-button-element.html#the-option-element", "HTMLOptionElement")}} + {{SpecName('HTML WHATWG', "the-button-element.html#the-option-element", "HTMLOptionElement")}} + {{Spec2('HTML WHATWG')}}

pas de changement depuis la {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "forms.html#the-option-element", "HTMLOptionElement")}} + {{SpecName('HTML5 W3C', "forms.html#the-option-element", "HTMLOptionElement")}} + {{Spec2('HTML5 W3C')}} -

Le constructeur, Option(), a été ajouté. la propriété form peut avoir la valeur null.

+

+ Le constructeur, Option(), a été ajouté. la propriété + form peut avoir la valeur null. +

{{SpecName('DOM2 HTML', 'html.html#ID-70901257', 'HTMLOptionElement')}} + {{SpecName('DOM2 HTML', 'html.html#ID-70901257', 'HTMLOptionElement')}} + {{Spec2('DOM2 HTML')}} -

Le sens de la propriété selected a changé: 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.

-

La propriété defaultSelected n'est plus en lecture seule

+

+ Le sens de la propriété selected a changé: 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. +

+

+ La propriété defaultSelected n'est plus en lecture seule +

{{SpecName('DOM1', 'level-one-html.html#ID-70901257', 'HTMLOptionElement')}} + {{SpecName('DOM1', 'level-one-html.html#ID-70901257', 'HTMLOptionElement')}} + {{Spec2('DOM1')}} La définition initiale .
-

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.HTMLOptionElement")}}

+{{Compat("api.HTMLOptionElement")}} -

Voir aussi

+## Voir aussi - +- 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 --- -
{{APIRef("HTML DOM")}}
+{{APIRef("HTML DOM")}} -

Le constructeur Option() permet de créer un nouvel objet {{domxref("HTMLOptionElement")}}.

+Le constructeur **`Option()`** permet de créer un nouvel objet {{domxref("HTMLOptionElement")}}. -

Syntaxe

+## Syntaxe -
var optionElementReference = new Option(text, value, defaultSelected, selected);
+ var optionElementReference = new Option(text, value, defaultSelected, selected); -

Parameters

+### Parameters -
-
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.
-
+- `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. -

Exemples

+## Exemples -

Ajouter de nouvelles options

+### Ajouter de nouvelles options -
/* 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
+
 */
 
 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);
 });
-
+``` -

Ajouter des options avec différents paramètres

+### Ajouter des options avec différents paramètres -
/* 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
+
 */
 
 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>
-*/
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
HTML5 La définition de Option dans cette spécification.Recommendation
+ +*/ +``` + +## 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 | | -- cgit v1.2.3-54-g00ecf