aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/window/getselection/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/api/window/getselection/index.md')
-rw-r--r--files/fr/web/api/window/getselection/index.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/files/fr/web/api/window/getselection/index.md b/files/fr/web/api/window/getselection/index.md
new file mode 100644
index 0000000000..579af3f9a0
--- /dev/null
+++ b/files/fr/web/api/window/getselection/index.md
@@ -0,0 +1,47 @@
+---
+title: window.getSelection
+slug: Web/API/Window/getSelection
+translation_of: Web/API/Window/getSelection
+---
+<p>{{ ApiRef() }}</p>
+
+<p>Renvoie un objet selection représentant le ou les objets sélectionnés.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="eval"><em>selection</em> = window.getSelection()
+</pre>
+
+<h2 id="Param.C3.A8tres">Paramètres</h2>
+
+<ul>
+ <li><code>selection</code> est un objet de type {{DOMxRef("Selection")}}.</li>
+</ul>
+
+<h2 id="Exemple">Exemple</h2>
+
+<pre class="eval">function foo() {
+ var selObj = window.getSelection();
+ alert(selObj);
+ var selRange = selObj.getRangeAt(0);
+ // travailler avec la sélection
+}
+</pre>
+
+<h2 id="Notes">Notes</h2>
+
+<p>En <a href="fr/JavaScript">JavaScript</a>, lorsqu'un objet de type Selection est passé à une fonction, c'est une représentation sous forme de chaîne (string), c'est-à-dire le texte sélectionné, qui lui est passée à la place. L'objet selection apparaît donc comme une chaîne, alors qu'il s'agit en réalité d'un objet possédant ses propres propriétés et méthodes. En pratique, c'est donc la valeur renvoyée par la méthode <code><a href="fr/DOM/Selection/toString">toString</a></code> de l'objet Selection qui est passée. Dans l'exemple ci-dessus, <code>selObj</code> est automatiquement « convertie » lorsqu'elle est passée à <a href="fr/DOM/window.alert">window.alert</a>. Cependant, pour utiliser une propriété ou méthode JavaScript de <a href="fr/JS/String">String</a> comme <code><a href="fr/JS/String.prototype.length">length</a></code> ou <code><a href="fr/JS/String.prototype.substr">substr</a></code>, il est nécessaire d'appeler manuellement la méthode <code>toString</code>. I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian</p>
+
+<h2 id="Sp.C3.A9cification">Spécification</h2>
+
+<p>DOM Level 0. Ne fait partie d'aucune spécification.</p>
+
+<h2 id="Voir_aussi">Voir aussi</h2>
+
+<ul>
+ <li><a href="../Selection_API">Selection API</a></li>
+ <li><a href="../Selection"><code>Selection</code></a></li>
+ <li><a href="../Range"><code>Range</code></a></li>
+ <li><a href="../Document/getSelection"><code>Document.getSelection()</code></a></li>
+ <li><a href="../HTMLInputElement/setSelectionRange"><code>HTMLInputElement.setSelectionRange()</code></a></li>
+</ul>