window.getSelection

Résumé

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 Selection.

Exemple

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

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.

Spécification

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

Voir aussi

Selection, Range