From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/htmloptionelement/index.html | 177 +++++++++++++++++++++ .../fr/web/api/htmloptionelement/option/index.html | 101 ++++++++++++ 2 files changed, 278 insertions(+) create mode 100644 files/fr/web/api/htmloptionelement/index.html create mode 100644 files/fr/web/api/htmloptionelement/option/index.html (limited to 'files/fr/web/api/htmloptionelement') diff --git a/files/fr/web/api/htmloptionelement/index.html b/files/fr/web/api/htmloptionelement/index.html new file mode 100644 index 0000000000..100dfce550 --- /dev/null +++ b/files/fr/web/api/htmloptionelement/index.html @@ -0,0 +1,177 @@ +--- +title: HTMLOptionElement +slug: Web/API/HTMLOptionElement +translation_of: Web/API/HTMLOptionElement +--- +
+ {{ApiRef}}
+

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

+

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.

+
+

Méthodes

+

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

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationEtatCommentaire
{{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")}}{{Spec2('HTML5 W3C')}} +

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

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

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

Compatibilité des navigateurs

+

{{CompatibilityTable}}

+
+ + + + + + + + + + + + + + + + + + + +
caractéristiqueChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
support basique{{CompatVersionUnknown}}{{CompatGeckoDesktop(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+
+ + + + + + + + + + + + + + + + + + + +
caractéristiqueAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
support basique{{CompatVersionUnknown}}{{CompatGeckoMobile(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+

Voir aussi

+ diff --git a/files/fr/web/api/htmloptionelement/option/index.html b/files/fr/web/api/htmloptionelement/option/index.html new file mode 100644 index 0000000000..80dc7f77cd --- /dev/null +++ b/files/fr/web/api/htmloptionelement/option/index.html @@ -0,0 +1,101 @@ +--- +title: Option() +slug: Web/API/HTMLOptionElement/Option +tags: + - API + - Constructeur + - HTML DOM + - HTMLOptionElement +translation_of: Web/API/HTMLOptionElement/Option +--- +
{{APIRef("HTML DOM")}}
+ +

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

+ +

Syntaxe

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

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

Exemples

+ +

Ajouter de nouvelles options

+ +
/* Imaginons qu'on ait le code HTML suivant dans le document
+<select id='s'>
+
+</select>
+*/
+
+var s = document.getElementById('s');
+var options = [Quatre, Cinq, Six];
+
+options.forEach(function(element,key) {
+    s[key] = new Option(element,key);
+});
+
+ +

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>
+*/
+
+var s = document.getElementById('s');
+var options = [ 'zéro', 'un', 'deux' ];
+
+options.forEach(function(element, key) {
+  if (element == 'zéro') {
+    s[s.options.length] = new Option(element, s.options.length, false, false);
+  }
+  if (element == 'un') {
+    s[s.options.length] = new Option(element, s.options.length, true, false); // Ajouter l'attribut "selected"
+  }
+  if (element == 'deux') {
+    s[s.options.length] = new Option(element, s.options.length, false, true); // Sélectionnera l'option
+  }
+});
+
+/* 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
+ The definition of 'Option' in that specification.		Recommendation
-- cgit v1.2.3-54-g00ecf