initial commit

2 files changed, 278 insertions, 0 deletions

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
+---
+<div>
+ {{ApiRef}}</div>
+<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>
+<h2 id="Propriétés"><em>Propriétés</em></h2>
+<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>
+</table>
+<h2 id="Méthodes">Méthodes</h2>
+<p><em>Hérite des méthodes de son parent , {{domxref("HTMLElement")}}.</em></p>
+<dl>
+ <dt>
+  {{domxref("HTMLOptionElement.Option()")}}</dt>
+ <dd>
+   </dd>
+ <dd>
+   </dd>
+ <dd>
+  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.</dd>
+</dl>
+<h2 id="Spécifications">Spécifications</h2>
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">Spécification</th>
+   <th scope="col">Etat</th>
+   <th scope="col">Commentaire</th>
+  </tr>
+  <tr>
+   <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>{{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>
+   </td>
+  </tr>
+  <tr>
+   <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>
+   </td>
+  </tr>
+  <tr>
+   <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="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+<p>{{CompatibilityTable}}</p>
+<div id="compat-desktop">
+ <table class="compat-table">
+  <tbody>
+   <tr>
+    <th><span class="short_text" id="result_box" lang="fr"><span class="hps">caractéristique</span></span></th>
+    <th>Chrome</th>
+    <th>Firefox (Gecko)</th>
+    <th>Internet Explorer</th>
+    <th>Opera</th>
+    <th>Safari (WebKit)</th>
+   </tr>
+   <tr>
+    <td>support basique</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatGeckoDesktop(1.0)}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+   </tr>
+  </tbody>
+ </table>
+</div>
+<div id="compat-mobile">
+ <table class="compat-table">
+  <tbody>
+   <tr>
+    <th><span class="short_text" id="result_box" lang="fr"><span class="hps">caractéristique</span></span></th>
+    <th>Android</th>
+    <th>Firefox Mobile (Gecko)</th>
+    <th>IE Phone</th>
+    <th>Opera Mobile</th>
+    <th>Safari Mobile</th>
+   </tr>
+   <tr>
+    <td>support basique</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatGeckoMobile(1.0)}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+    <td>{{CompatVersionUnknown}}</td>
+   </tr>
+  </tbody>
+ </table>
+</div>
+<h2 id="Voir_aussi">Voir aussi</h2>
+<ul>
+ <li>L'élement HTML  implèmentant cette interface : {{ HTMLElement("option") }}.</li>
+</ul>
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
+---
+<div>{{APIRef("HTML DOM")}}</div>
+
+<p>Le constructeur <strong><code>Option()</code></strong> permet de créer un nouvel objet {{domxref("HTMLOptionElement")}}.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<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>
+
+<h3 id="Parameters">Parameters</h3>
+
+<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>
+
+<h2 id="Exemples">Exemples</h2>
+
+<h3 id="Ajouter_de_nouvelles_options">Ajouter de nouvelles options</h3>
+
+<pre class="brush: js">/* Imaginons qu'on ait le code HTML suivant dans le document
+&lt;select id='s'&gt;
+
+&lt;/select&gt;
+*/
+
+var s = document.getElementById('s');
+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>
+
+<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;
+*/
+
+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é :
+&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 class="external external-icon" href="http://www.w3.org/TR/2012/WD-html5-20121025/the-option-element.html#dom-option" hreflang="en" lang="en">HTML5<br>
+    <small lang="en-US">The definition of 'Option' in that specification.</small></a></td>
+   <td>Recommendation</td>
+   <td></td>
+  </tr>
+ </tbody>
+</table>