window.getSelection
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Renvoie un objet selection représentant le ou les objets sélectionnés.
Syntaxe
selection = window.getSelection();
Paramètres
selection
est un objet de typeSelection
.
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
. 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.