diff options
Diffstat (limited to 'files/fr/web/api/window/getselection/index.md')
-rw-r--r-- | files/fr/web/api/window/getselection/index.md | 47 |
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> |