blob: 6b2f7b37961df198af26130eb693c2329bdad344 (
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
|
---
title: window.getSelection
slug: Web/API/Window/getSelection
translation_of: Web/API/Window/getSelection
---
{{ ApiRef() }}
Renvoie un objet selection représentant le ou les objets sélectionnés.
## Syntaxe
selection = window.getSelection()
## Paramètres
- `selection` est un objet de type {{DOMxRef("Selection")}}.
## Exemple
function foo() {
var selObj = window.getSelection();
alert(selObj);
var selRange = selObj.getRangeAt(0);
// travailler avec la sélection
}
## Notes
En [JavaScript](fr/JavaScript), 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 [`toString`](fr/DOM/Selection/toString) de l'objet Selection qui est passée. Dans l'exemple ci-dessus, `selObj` est automatiquement « convertie » lorsqu'elle est passée à [window.alert](fr/DOM/window.alert). Cependant, pour utiliser une propriété ou méthode JavaScript de [String](fr/JS/String) comme [`length`](fr/JS/String.prototype.length) ou [`substr`](fr/JS/String.prototype.substr), il est nécessaire d'appeler manuellement la méthode `toString`. I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian
## Spécification
DOM Level 0. Ne fait partie d'aucune spécification.
## Voir aussi
- [Selection API](../Selection_API)
- [`Selection`](../Selection)
- [`Range`](../Range)
- [`Document.getSelection()`](../Document/getSelection)
- [`HTMLInputElement.setSelectionRange()`](../HTMLInputElement/setSelectionRange)
|
