L´objet TextRange, similaire conceptuellement à l´objet Range de Netscape 6 et du DOM W3C, représente une séquence de zéro caractère de texte affiché ou plus dans un document. Une plage de texte comprenant zéro caractère représente un point d'insertion situé entre deux caractères (il peut également se situer avant le premier ou après le dernier caractère).

Renvoient la mesure en pixels de l'espace imaginaire occupé par l'objet TextRange. Bien que l'objet TextRange ne soit pas visible dans le document (à moins qu'un script ne le sélectionne), la zone d'un objet TextRange est identique à celle qu'occuperait une zone sélectionnée en surbrillance. Ces valeurs sont ajustées de telle sorte à ne pas dépasser la hauteur et la largeur maximales de la plage. Vous arriveriez aux mêmes résultats en effectuant des calculs arithmétiques sur les valeurs renvoyées par la méthode getBoundingClientRect().

Renvoient la distance en pixels séparant la partie supérieure ou gauche de la fenêtre ou du cadre du navigateur des bords supérieur ou gauche de l'espace imaginaire occupé par l'objet TextRange. Bien que l'objet TextRange ne soit pas visible dans le document (à moins qu'un script ne le sélectionne), la zone d'un objet TextRange est identique à celle qu'occuperait une zone sélectionnée en surbrillance. Les valeurs de ces propriétés sont mesurées à partir des bords fixes de la fenêtre ou du cadre et non à partir de la partie supérieure et gauche du document qui peut être masquée lorsque le document défile. Dès lors, ces valeurs changent lorsque le document défile.

Spécifie tout code HTML du document pour un élément donné, lorsque ce dernier sert de base à un objet TextRange. Par exemple, si vous créez un objet TextRange pour l'élément body (document.body.createTextRange()), la propriété htmlText englobe tout le contenu HTML inclus entre des balises d'élément body (ces dernières non comprises).

Indique le texte contenu dans la plage de texte. Dans le cas d'un objet TextRange d'un élément body, il s'agit du texte affiché, sans les balises HTML.

Réduit l'objet TextRange à une longueur zéro (créant un point d'insertion) au début ou à la fin de la plage de texte avant réduction.

Compare la position relative des points de début et de fin de deux plages (la plage active et celle préalablement enregistrée comme variable). Le premier paramètre définit les points de début et de fin de chaque plage que vous souhaitez comparer. Si le résultat de la comparaison montre que le premier point se trouve avant l´autre point dans la plage, la valeur renvoyée est -1. Si le résultat montre que les deux points sont au même emplacement, la valeur renvoyée est 0. Si le résultat de la comparaison montre que le premier point se trouve après l´autre point dans la plage, la valeur renvoyée est 1. Par exemple, si vous avez enregistré la première plage dans une variable r1 et créé une nouvelle plage intitulée r2, vous pouvez voir la relation physique entre la fin de r2 et le début de r1:

r1.compareEndPoints("EndToStart", r2)

Crée un nouvel objet TextRange ayant les mêmes valeurs que la plage active. Le nouvel objet est indépendant; l'ancien et le nouveau ne sont pas égaux mais, initialement, leurs valeurs sont identiques (tant que vous ne modifiez pas une plage ou l'autre).

Exécute la commande nommée dans l'objet TextRange actif. Dans bien des cas, les commandes fonctionnent mieux lorsque l'objet TextRange est un point d'insertion. Reportez-vous à l´annexe D pour une liste de commandes.

Etend la plage de texte courante (y compris une plage réduite) afin d'englober l'unité textuelle transmise comme paramètre. Par exemple, si quelqu'un sélectionne certains caractères d'un document, vous pouvez créer la plage et l'étendre afin qu'elle englobe toute la phrase dans laquelle figurent les caractères sélectionnés:

var rng = document.selection.createRange( );
rng.expand("sentence");

Recherche, dans l'objet TextRange actif, une correspondance avec une chaîne transmise comme le premier paramètre requis. Par défaut, la mise en correspondance ne tient pas compte de la casse. En présence d'une correspondance, l'objet TextRange repositionne ses points de début et de fin de telle sorte à englober le texte trouvé. Pour poursuivre la recherche dans le document, repositionnez le point de départ de la plage de texte à la fin de la chaîne trouvée (avec collapse()).

Associées, ces deux méthodes permettent d'enregistrer temporairement la spécification d'une plage de texte et de la récupérer si nécessaire. La méthode getBookmark() renvoie une chaîne opaque (contenant des données binaires sans intérêt pour l'utilisateur). Une fois la valeur stockée dans une variable, il est possible de modifier la plage au gré des besoins pour le script. La plage de texte balisée d'un signet peut être récupérée à un stade ultérieur gr ce à la méthode moveToBookmark():

var rangeMark = myRange.getBookmark( );
...
myRange.moveToBookmark(rangeMark);

Détermine si la plage faisant l'objet de la comparaison est contenue dans la plage physique de la plage de texte active ou se confond avec elle.

Détermine si la plage faisant l'objet de la comparaison est identique à la plage de texte active.

Réduit la plage de texte active à un point d'insertion situé à la fin de la plage de texte active et le déplace d'une ou plusieurs unités vers l'avant ou vers l'arrière par rapport à la position actuelle.

Déplace uniquement le point de fin ou de début (respectivement) de la plage de texte active d'une (ou plusieurs) unité(s). Un paramètre facultatif vous permet de spécifier à la fois le nombre d'unités et la direction. Pour replacer le point de départ d'une plage de texte au début de la plage originale, n'oubliez pas d'indiquer une valeur négative. Lorsque vous déplacez le point de fin vers l´avant par unités de mots, songez que le mot se termine par un espace blanc (comprenant un point). Dès lors, si une méthode findText() définit la plage sur une chaîne qui ne se termine pas par un espace, la première méthode moveEnd("word") place le point de fin à l'emplacement situé derrière l'espace suivant la chaîne trouvée, au lieu de le placer au mot suivant.

Voir getBookmark().

Déplace les points de début et de fin de l'objet TextRange de manière à englober l'objet élément HTML spécifié. La plage de texte qui en résulte inclut également le code HTML relatif à l'élément.

Réduit la plage de texte à un point d'insertion et définit sa position sur le point indiqué par les coordonnées horizontales et verticales dans la fenêtre ou le cadre du navigateur. Cela revient au même que cliquer sur un point de la fenêtre pour définir un point d'insertion. Utilisez des méthodes telles que expand() pour élargir la plage de texte afin d'inclure un caractère, un mot, une phrase ou une plage de texte complète.

Renvoie une référence d'objet à l'élément père contenant l'objet TextRange.

Remplace la plage de texte active par le contenu HTML fourni comme chaîne de paramètre. En général, cette méthode est utilisée sur un objet de plage de texte de longueur zéro faisant office de pointeur d'insertion. Toutes les balises sont affichées comme si elles faisaient partie du code source original.

Détermine si la commande peut être invoquée en fonction de l'état actuel du document ou de la sélection.

Détermine si la commande est dans un état indéterminé.

Détermine l'état courant de la commande indiquée.

Détermine si la commande nommée est prise en charge par l'objet document.

Renvoie le texte associé à la commande.

Renvoie la valeur associée à la commande, tel le nom de police de la sélection.

Sélectionne tout le texte inclus dans l'objet TextRange actif. Cette méthode confirme visuellement à l'utilisateur que le script reconnaît un bloc de texte particulier. Par exemple, si vous créez un script de recherche avec la méthode findText(), l'utilisation des méthodes scrollIntoView() et select() sur cette plage permet de montrer à l'utilisateur où se trouve le texte correspondant à la recherche.

Paramètre le point de fin de l'objet TextRange actif sur le point de fin d'une autre plage préalablement enregistrée comme variable de référence.