From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/window/getselection/index.md | 52 ++++++++++++--------------- 1 file changed, 23 insertions(+), 29 deletions(-) (limited to 'files/fr/web/api/window/getselection') diff --git a/files/fr/web/api/window/getselection/index.md b/files/fr/web/api/window/getselection/index.md index 579af3f9a0..6b2f7b3796 100644 --- a/files/fr/web/api/window/getselection/index.md +++ b/files/fr/web/api/window/getselection/index.md @@ -3,45 +3,39 @@ title: window.getSelection slug: Web/API/Window/getSelection translation_of: Web/API/Window/getSelection --- -

{{ ApiRef() }}

+{{ ApiRef() }} -

Renvoie un objet selection représentant le ou les objets sélectionnés.

+Renvoie un objet selection représentant le ou les objets sélectionnés. -

Syntaxe

+## Syntaxe -
selection = window.getSelection()
-
+ selection = window.getSelection() -

Paramètres

+## Paramètres - +- `selection` est un objet de type {{DOMxRef("Selection")}}. -

Exemple

+## Exemple -
function foo() {
-   var selObj = window.getSelection();
-   alert(selObj);
-   var selRange = selObj.getRangeAt(0);
-   // travailler avec la sélection
-}
-
+ function foo() { + var selObj = window.getSelection(); + alert(selObj); + var selRange = selObj.getRangeAt(0); + // travailler avec la sélection + } -

Notes

+## Notes -

En 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 de l'objet Selection qui est passée. Dans l'exemple ci-dessus, selObj est automatiquement « convertie » lorsqu'elle est passée à window.alert. Cependant, pour utiliser une propriété ou méthode JavaScript de String comme length ou 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

+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

+## Spécification -

DOM Level 0. Ne fait partie d'aucune spécification.

+DOM Level 0. Ne fait partie d'aucune spécification. -

Voir aussi

+## Voir aussi - +- [Selection API](../Selection_API) +- [`Selection`](../Selection) +- [`Range`](../Range) +- [`Document.getSelection()`](../Document/getSelection) +- [`HTMLInputElement.setSelectionRange()`](../HTMLInputElement/setSelectionRange) -- cgit v1.2.3-54-g00ecf