L'objet selection représente zéro ou plusieurs caractères sélectionnés explicitement par l'utilisateur ou par script. Les objets sont des entités très différentes dans les navigateurs IE et Navigator (consultez les niveaux de compatibilité pour les propriétés et les méthodes ci-dessous) et chacun d´entre eux a sa façon propre de fournir l´accès aux scripts.

Renvoie une référence au noeud où l´utilisateur a commencé (ancre) et terminé (activation) la sélection. Généralement, il s´agit de types de noeuds de texte. Si la sélection est définie ou élargie par le biais de la méthode addRange(), ces propriétés pointent sur les extrémités de noeud de la plage la plus récemment ajoutée.

Renvoie un nombre entier de caractères ou de noeuds du début des noeuds d´ancre ou d´activation de la sélection (reportez-vous aux propriétés anchorNode et focusNode). S´il s´agit d´un noeud de texte, l´unité de décalage est le caractère; s´il s´agit d´un noeud élément, l´unité de décalage est le noeud. Ce comportement est similaire aux propriétés de décalage de l´objet Range. Généralement, ces valeurs comptent les caractères dans les types de noeuds de texte. Si la sélection est définie ou élargie par le biais de la méthode addRange(), ces propriétés pointent vers les décalages des extrémités de noeud de la plage la plus récemment ajoutée.

Renvoie la valeur booléenne true si les extrémités d´ancre et d´activation d´une sélection sont identiques.

Renvoie un nombre entier d´objets Range (qui peuvent être non contigus dans Netscape 6) dans l´étendue de la sélection. Une sélection manuelle de l´utilisateur contient toujours un objet Range, mais la méthode addRange() peut ajouter plusieurs plages non contiguës à la sélection. Pour passer en revue les propriétés de chaque section sélectionnée, utilisez la méthode getRangeAt().

Indique si un ou plusieurs caractères sont sélectionnés pour l'objet selection courant ou s'il s'agit simplement d'un point d'insertion.

Cette propriété est fournie comme paramètre fictif pour les autres applications pouvant utiliser le composant du navigateur IE. Une telle application peut fournir des informations supplémentaires sur le type de sélection si nécessaire.

Transforme un objet Range en sélection en surbrillance sur la page. Vous pouvez ajouter autant de plages non contiguës à la sélection que votre application l´exige. Chaque ajout incrémente la propriété rangeCount de l´objet selection. Les plages peuvent aussi se chevaucher dans une sélection.

Supprime le contenu de la sélection de texte courante dans le document. Par exemple, le gestionnaire d'événements de la balise suivante supprime tout texte sélectionné de l'élément p deux secondes après que l'utilisateur commence à opérer sa sélection:

<p onselectstart="setTimeout('document.selection.clear( )',2000);>"

Réduit la sélection courante à un emplacement spécifié par deux paramètres. Toute sélection précédemment en surbrillance retourne à l´affichage normal.

Réduit la sélection courante à un emplacement au début (collapseToStart()) ou à la fin (collapseToEnd()) de l´objet selection. Toute sélection précédemment en surbrillance retourne à l´affichage normal. Si la sélection est composée de plusieurs plages, les extrémités de début et de fin pour ces méthodes de réduction sont les bords les plus extérieurs de la sélection combinée. Après la réduction, la sélection ne comprend plus qu´une plage.

Renvoie la valeur booléenne true si l´objet de sélection courant contient un noeud transmis comme paramètre. Le deuxième paramètre est censé vous permettre d´élargir ou de réduire la définition des conteneurs, mais le comportement de la méthode semble faire l´inverse de l´objectif prévu du drapeau. Pour garantir la précision, transmettez null comme deuxième paramètre, ce qui force la méthode à définir les conteneurs comme contenant la totalité du noeud.

Crée un objet TextRange à partir de l'objet selection courant. Après une instruction telle que:

var myRange = document.selection.createRange( );

Crée un objet de collection TextRange. Cela doit servir à anticiper la prise en charge future par IE de plusieurs sélections non contiguës.

Supprime la sélection courante de l´arborescence de documents. La hiérarchie des noeuds s´ajuste en obéissant aux mêmes règles que Range.deleteContents().

Annule la sélection en cours et paramètre la propriété type de l'objet selection sur None. Aucun changement n'est apporté au contenu sélectionné.

Déplace l´extrémité de fin (activation) de la sélection jusqu´au noeud de l´arborescence de documents désigné et au décalage au sein de ce noeud. Le point de début (ancre) ne se déplace pas dans le cadre de cette méthode.

Renvoie une référence à la plage dans l´objet selection dont l´index numérique en base zéro correspond au paramètre transmis. Pour les sélections contiguës, le paramètre doit être zéro. Mais pour les sélections non contiguës, la méthode getRangeAt() vous permet d´extraire chaque plage qui a été ajoutée à la sélection pour que vous puissiez la manipuler individuellement comme un objet Range. Utilisez la propriété selection.rangeCount pour dériver le nombre d´objets Range contenus dans l´objet selection. L´invocation de la méthode ne modifie pas la séquence des plages au sein de la sélection.

Supprime tous les objets Range de la sélection courante (pas de l´arborescence de documents). La sélection est réduite et la valeur de la propriété rangeCount passe à zéro.

Supprime un objet Range de la sélection courante (pas de l´arborescence de documents). Dans le cas d´une sélection avec plusieurs plages, vous pouvez effectuer une recherche itérative dans tous les objets Range, tous les passer en revue pour trouver certains critères et supprimer celui ou ceux que vous voulez avec la séquence suivante:

var oneRange;
var sel = window.getSelection( );
for (var i = 0; i< sel.rangeCount; i++) {
    oneRange = sel.getRangeAt(i);
    if (oneRange. someProperty == someDiscerningValue) {
        sel.removeRange(oneRange);
    }
}

Force l´objet selection à englober le noeud élément transmis comme paramètre, ainsi que tous ses noeuds enfants. Cette méthode est aussi un raccourci permettant d´utiliser un script pour sélectionner un noeud élément. L´utilisation de cette méthode pour un noeud élément fait des noeuds d´ancre et d´activation ce noeud élément. Si vous transmettez une référence à un noeud de texte, la sélection en résultant est réduite devant le premier caractère du noeud de texte. L´invocation de cette méthode pour une sélection existante remplace toutes les plages par la nouvelle plage englobant l´élément.

Contrôle le niveau bidi (bidirectionnel) du curseur.

Renvoie une chaîne contenant seulement le contenu du corps à partir de la sélection. Les balises et attributs sont ignorés.