blob: 579af3f9a081c2899263ba62e8849c78010135e8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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>
|
