window.getSelection

  • Raccourci de la révision : DOM/window.getSelection
  • Titre de la révision : window.getSelection
  • ID de la révision : 182242
  • Créé :
  • Créateur : BenoitL
  • Version actuelle ? Non
  • Commentaire traduction

Contenu de la révision

{{template.DomRef()}}

Résumé

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

Syntaxe

selection = window.getSelection() 

Paramètres

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.

Voir aussi

Selection, Range

{{ wiki.languages( { "en": "en/DOM/window.getSelection" } ) }}

Source de la révision

<p>
{{template.DomRef()}}
</p>
<h3 name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p>Renvoie un objet selection représentant le ou les objets sélectionnés. 
</p>
<h3 name="Syntaxe"> Syntaxe </h3>
<pre class="eval"><i>selection</i> = window.getSelection() 
</pre>
<h3 name="Param.C3.A8tres"> Paramètres </h3>
<ul><li> <code>selection</code> est un objet de type <a href="fr/DOM/Selection">Selection</a>.
</li></ul>
<h3 name="Exemple"> Exemple </h3>
<pre class="eval">function foo() {
   var selObj = window.getSelection(); 
   alert(selObj);
   var selRange = selObj.getRangeAt(0);
   // travailler avec la sélection
}
</pre>
<h3 name="Notes"> Notes </h3>
<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>.
<span class="comment">I'm treading carefully with the word "convert" here because it could be misinterpreted as a permanent convert - Maian</span>
</p>
<h3 name="Sp.C3.A9cification"> Spécification </h3>
<p>DOM Level 0. Ne fait partie d'aucune spécification.
</p>
<h3 name="Voir_aussi"> Voir aussi </h3>
<p><a href="fr/DOM/Selection">Selection</a>, <a href="fr/DOM/range">Range</a>
</p>{{ wiki.languages( { "en": "en/DOM/window.getSelection" } ) }}
Revenir à cette révision