initial commit

4 files changed, 326 insertions, 0 deletions

diff --git a/files/fr/web/api/selection/collapse/index.html b/files/fr/web/api/selection/collapse/index.html
new file mode 100644
index 0000000000..9eff106240
--- /dev/null
+++ b/files/fr/web/api/selection/collapse/index.html
@@ -0,0 +1,119 @@
+---
+title: Selection.collapse()
+slug: Web/API/Selection/collapse
+tags:
+  - API
+  - Edition HTML
+  - Experimental
+  - Method
+  - Reference
+  - Selection
+translation_of: Web/API/Selection/collapse
+---
+<div>{{ApiRef("DOM")}}{{SeeCompatTable}}</div>
+
+<p>La méthode <strong><code>Selection.collapse()</code></strong> positionne la sélection en cours en un seul point. Le document n'est pas modifié. Si le focus est sur le contenu et est modifiable, le curseur d'édition s'y positionnera et sera visible.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox"><var>sel</var>.collapse(<var>parentNode</var>, <var>offset</var>);
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><em><code>parentNode</code></em></dt>
+ <dd>Le curseur d'édition sera placé à l'intérieur de ce noeud.</dd>
+</dl>
+
+<dl>
+ <dt><em><code>offset</code></em></dt>
+ <dd>Indique la position du curseur d'édition dans <code>parentNode</code>.</dd>
+</dl>
+
+<h2 id="Exemples">Exemples</h2>
+
+<pre class="brush: js">/* Positionner le curseur au début de l'élément body d'un document HTML. */
+var body = document.getElementsByTagName("body")[0];
+window.getSelection().collapse(body,0);
+</pre>
+
+<h2 id="Spécifications">Spécifications</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">Spécification</th>
+   <th scope="col">Statut</th>
+   <th scope="col">Commentaires</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('Selection API', '#widl-Selection-collapse-void-Node-node-unsigned-long-offset', 'Selection.collapse()')}}</td>
+   <td>{{Spec2('Selection API')}}</td>
+   <td> </td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML Editing', '#dom-selection-collapse', 'Selection.collapse()')}}</td>
+   <td>{{Spec2('HTML Editing')}}</td>
+   <td>Définition initiale</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilité">Compatibilité</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Fonctionnalité</th>
+   <th>Chrome</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari (WebKit)</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>9.0</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Fonctionnalité</th>
+   <th>Android</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>Firefox OS</th>
+   <th>IE Phone</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>1.0</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>{{CompatUnknown}}</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="Voir_aussi">Voir aussi</h2>
+
+<ul>
+ <li>{{domxref("Selection")}}, l'interface à laquelle collapse appartient.</li>
+</ul>
diff --git a/files/fr/web/api/selection/index.html b/files/fr/web/api/selection/index.html
new file mode 100644
index 0000000000..b6dc3d0940
--- /dev/null
+++ b/files/fr/web/api/selection/index.html
@@ -0,0 +1,106 @@
+---
+title: selection
+slug: Web/API/Selection
+translation_of: Web/API/Selection
+---
+<p>{{ ApiRef() }}</p>
+
+<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h3>
+
+<p>La classe de l'objet retourné par <code><a href="Window/getSelection"> window.getSelection()</a></code>, <a href="https://developer.mozilla.org/fr/docs/Web/API/Document/getSelection" title="Cette méthode fonctionne de manière identique à la méthode Window.getSelection () ; elle renvoie un objet Selection représentant le texte actuellement sélectionné dans le document."><code>document.getSelection()</code></a> et d'autres méthodes.</p>
+
+<h3 id="Description" name="Description">Description</h3>
+
+<p>Un objet <code>selection</code> représente les <a href="range">plages</a> sélectionnées par l'utilisateur. Habituellement, il ne contient qu'une seule plage accessible comme ceci :</p>
+
+<pre class="eval">range = sel.getRangeAt(0);
+</pre>
+
+<p>L'appel de la méthode <code><a href="Selection/toString">toString()</a></code> renvoie le texte contenu dans la sélection. Cet appel peut être automatique, par exemple lorsque l'objet est passé à la fonction alert() : </p>
+
+<pre class="eval">selObj = window.getSelection();
+window.alert(selObj);
+</pre>
+
+<h3 id="Glossaire" name="Glossaire">Glossaire</h3>
+
+<p>Autres mots clés utilisés dans cette section.</p>
+
+<dl>
+ <dt>anchor (ancre)</dt>
+ <dd>L'« ancre » d'une sélection est son point de départ. Pour une sélection avec la souris, l'« ancre » correspond à l'endroit initialement pressé par le bouton de la souris. Quand l'utilisateur modifie la sélection à la souris ou au clavier, l'« ancre » ne change pas.</dd>
+ <dt>focus (focus)</dt>
+ <dd>Le « focus » d'une sélection est son point d'arrivée. Pour une sélection avec la souris, le « focus » correspond à l'endroit où le bouton de la souris est relaché. Quand l'utilisateur modifie la sélection à la souris ou au clavier, le « focus » pointe la fin de la sélection modifiée.</dd>
+ <dt>range (plage)</dt>
+ <dd>Une « plage » est une partie contigüe d'un document. Une « plage » peut contenir aussi bien des nœuds entiers que des portions de nœuds, comme un extrait de nœud texte. Habituellement, un utilisateur n'effectuera qu'une seule sélection à la fois, mais il lui est possible de sélectionner plusieurs « plages » (par ex. en utilisant la touche Ctrl). Une « plage » est obtenue depuis une sélection par l'objet <a href="range">range</a>. Les objets <code>range</code> peuvent également être créés via le DOM et ajoutés ou supprimés d'une sélection par programmation.</dd>
+</dl>
+
+<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3>
+
+<dl>
+ <dt><a href="/fr/docs/Web/API/Selection/anchorNode">anchorNode</a></dt>
+ <dd>Renvoie le nœud d'où la sélection commence.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/anchorOffset">anchorOffset</a></dt>
+ <dd>Renvoie un nombre correspondant au décalage de l'« ancre » de la sélection au sein de l'<code>anchorNode</code>. Si l'<code>anchorNode</code> est un noeud texte, il s'agit du nombre de caractères précédants l'« ancre » au sein de l'<code>anchorNode</code>. Si l'<code>anchorNode</code> est un élément, il s'agit du nombre de noeuds enfants de l'<code>anchorNode</code> précédant l'« ancre ».</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/focusNode">focusNode</a></dt>
+ <dd>Renvoie le nœud où la sélection se termine.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/focusOffset">focusOffset</a></dt>
+ <dd>Renvoie un nombre correspondant au décalage du « focus » de la sélection au sein du focus<code>Node</code>. Si le focus<code>Node</code> est un noeud texte, il s'agit du nombre de caractères précédants le « focus » au sein du focus<code>Node</code>. Si le focusNode est un élément, il s'agit du nombre de noeuds enfants du focus<code>Node</code> précédant le « focus ».</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/isCollapsed">isCollapsed</a></dt>
+ <dd>Renvoie un booléen indiquant si le point de départ et d'arrivée sont à la même position.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/rangeCount">rangeCount</a></dt>
+ <dd>Renvoie le nombre de « plages » dans la sélection.</dd>
+</dl>
+
+<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3>
+
+<dl>
+ <dt><a href="/fr/docs/Web/API/Selection/getRangeAt">getRangeAt</a></dt>
+ <dd>Renvoie un objet range représentant une des « plages » actuellement sélectionnée.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/collapse">collapse</a></dt>
+ <dd>Réduit la sélection courante à un simple point.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/extend">extend</a></dt>
+ <dd>Déplace le « focus » de la sélection à un endroit spécifié.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/collapseToStart">collapseToStart</a></dt>
+ <dd>Déplace le « focus » de la sélection au même point que l'« ancre ».</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/collapseToEnd">collapseToEnd</a></dt>
+ <dd>Déplace l'« ancre » de la sélection au même point que le « focus ». Le « focus » ne bouge pas.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/selectAllChildren">selectAllChildren</a></dt>
+ <dd>Ajoute tous les enfants d'un nœud spécifié à la sélection.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/addRange">addRange</a></dt>
+ <dd>Un objet range devant être ajouté à la sélection.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/removeRange">removeRange</a></dt>
+ <dd>Supprime une « plage » de la sélection.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/removeAllRanges">removeAllRanges</a></dt>
+ <dd>Supprime toutes les « plages » de la sélection.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/deleteFromDocument">deleteFromDocument</a></dt>
+ <dd>Efface le contenu de la sélection du document.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/selectionLanguageChange">selectionLanguageChange</a></dt>
+ <dd> </dd>
+ <dt><a href="/fr/docs/Web/API/Selection/toString">toString</a></dt>
+ <dd>Renvoie une chaîne de caractères représentant l'actuel objet <code>selection</code>, i.e. le texte sélectionné.</dd>
+ <dt><a href="/fr/docs/Web/API/Selection/containsNode">containsNode</a></dt>
+ <dd>Indique si un nœud donné appartient à la sélection.</dd>
+</dl>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilité des navigateurs</h2>
+
+
+
+<p>{{Compat("api.Selection")}}</p>
+
+<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3>
+
+<p><a href="Window/getSelection">window.getSelection</a>, <a href="https://developer.mozilla.org/fr/docs/Web/API/Document/getSelection" title="Cette méthode fonctionne de manière identique à la méthode Window.getSelection () ; elle renvoie un objet Selection représentant le texte actuellement sélectionné dans le document."><code>document.getSelection()</code></a>,<a href="range">Range</a></p>
+
+<h3 id="Liens_externes" name="Liens_externes">Liens externes</h3>
+
+<ul>
+ <li><a class="external" href="http://lxr.mozilla.org/mozilla/source/content/base/public/nsISelection.idl">Définition IDL dans Mozilla cross-reference</a></li>
+</ul>
+
+<p> </p>
+
+<div class="noinclude"> </div>
+
+<p>{{ languages( { "en": "en/DOM/Selection", "es": "es/DOM/Selection", "it": "it/DOM/Selection", "ja": "ja/DOM/selection", "pl": "pl/DOM/Selection" } ) }}</p>
diff --git a/files/fr/web/api/selection/tostring/index.html b/files/fr/web/api/selection/tostring/index.html
new file mode 100644
index 0000000000..760100faa5
--- /dev/null
+++ b/files/fr/web/api/selection/tostring/index.html
@@ -0,0 +1,31 @@
+---
+title: toString
+slug: Web/API/Selection/toString
+tags:
+  - Référence_du_DOM_Gecko
+translation_of: Web/API/Selection/toString
+---
+<p>{{ ApiRef() }}</p>
+<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h3>
+<p>Renvoie une chaîne de caractères représentant l'actuel objet <code>selection</code>, i.e. le texte sélectionné.</p>
+<h3 id="Syntaxe" name="Syntaxe">Syntaxe</h3>
+<pre class="eval"><i>string</i> =<i>sel</i>.toString()
+</pre>
+<ul>
+ <li><code>string</code> est la représentation sous la forme d'une chaîne de caractères de la sélection.</li>
+</ul>
+<h3 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h3>
+<p>Aucun.</p>
+<h3 id="Description" name="Description">Description</h3>
+<p>Cette méthode renvoie le texte sélectionné.</p>
+<p>En <a href="fr/JavaScript">JavaScript</a>, cette méthode est appelée automatiquement pour des objets <code>selection</code> aux fonctions nécessitant un paramètre <code>string</code> :</p>
+<pre class="eval">alert(window.getSelection()) // Appel automatique
+alert(window.getSelection().toString())  // Appel explicite
+</pre>
+<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3>
+<ul>
+ <li><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Object/toString">Object.toString</a></li>
+</ul>
+<div class="noinclude">
+  </div>
+<p>{{ languages( { "en": "en/DOM/Selection/toString", "es": "es/DOM/Selection/toString", "it": "it/DOM/Selection/toString", "pl": "pl/DOM/Selection/toString" } ) }}</p>
diff --git a/files/fr/web/api/selection/type/index.html b/files/fr/web/api/selection/type/index.html
new file mode 100644
index 0000000000..6f6032891a
--- /dev/null
+++ b/files/fr/web/api/selection/type/index.html
@@ -0,0 +1,70 @@
+---
+title: Selection.type
+slug: Web/API/Selection/type
+tags:
+  - API
+  - Experimental
+  - Propriété
+  - Reference
+  - Type
+translation_of: Web/API/Selection/type
+---
+<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div>
+
+<p>La propriété en lecture simple <strong><code>type</code></strong> de l'interface {{domxref("Selection")}} retourne un {{domxref("DOMString")}} décrivant le type de la sélection courante.</p>
+
+<h2 id="Syntax">Syntax</h2>
+
+<pre class="syntaxbox"><em>value</em> =<em> sel</em>.type
+</pre>
+
+<h3 id="Value">Value</h3>
+
+<p>Une {{domxref("DOMString")}} décrivant le type de la sélection courante. Les valeurs possibles sont :</p>
+
+<ul>
+ <li><code>None</code>: Aucune sélection courante.</li>
+ <li><code>Caret</code>: La sélection est réduite (le curseur est dans un texte mais il n'y a pas de plage sélectionnée).</li>
+ <li><code>Range</code>: Une plage est sélectionnnée.</li>
+</ul>
+
+<h2 id="Exemple">Exemple</h2>
+
+<p>Dans cet exemple le gestionnaire d'évènemenet est activé à chaque changement de la sélection. <code>console.log(selection.type)</code> retourne <code>Caret</code> ou <code>Range</code> selon que le curseur est sur un simple caractère ou qu'une plage est sélectionée.</p>
+
+<pre class="brush: js">var selection;
+
+document.onselectionchange = function() {
+  console.log('New selection made');
+  selection = document.getSelection();
+  console.log(selection.type);
+};</pre>
+
+<h2 id="Spécifications">Spécifications</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('Selection API', '#dom-selection-type', 'Selection.type')}}</td>
+   <td>{{Spec2('Selection API')}}</td>
+   <td>Courant</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+
+
+<p>{{Compat("api.Selection.type")}}</p>
+
+<h2 id="Voir_aussi">Voir aussi</h2>
+
+<ul>
+ <li>{{domxref("Selection")}}</li>
+</ul>