L'Altruiste : Le Javascript

TextRange représente du texte dans un document HTML.

Compatibilité

Disponibilité

Jcript

Constructeur

createTextRange()

Propriétés

Propriété	Description
htmlText	retourne la source HTML comme un fragment HTML valide.
text	change ou récupère la chaîne de caractères contenue dans l'objet TextRange.
boundingHeight	récupère la hauteur du rectangle qui limite le TextRange.
boundingLeft	récupère la coordonnée horizontale qui limite le TextRange.
boundingTop	récupère la coordonnée verticale qui limite le TextRange.
boundingWidth	récupère la largeur du rectangle qui limite le TextRange.
offsetLeft	retourne la position gauche calculée, en pixels, par rapport à la fenêtre.
offsetTop	retourne la position supérieure calculée, en pixels, par rapport à la fenêtre.

Méthodes

Méthode	Description
collapse(bool_départ)	déplace le point d'insertion au début ou à la fin de l'objet texte courant.
compareEndPoints(type, obj_texte)	compare deux points de fin et retourne -1, 0, ou 1 pour moins que, égal à , ou plus grand que, respectivement.
duplicate()	retourne un objet TextRange dupliqué.
execCommand(commande, Interface, Valeur)	exécute une commande sur la sélection donnée ou l'objet texte spécifié.
expand(type)	étend l'objet texte pour que des unités partielles soient complètement contenues.
findText(texte, Type_Recherche, Drapeau)	permet de retrouver une chaîne de caractères dans un objet texte.
getBookmark()	récupère un signet qui peut être employé avec moveToBookmark pour retourner au même objet TextRange.
inRange(Référence_TextRange)	retourne true si le paramètre de la méthode est contenu dans l'objet TextRange ou est égal à ce dernier sur lequel la méthode est appelée.
isEqual(Objet_TextRange)	retourne true si le paramètre de la méthode est égal à l'objet TextRange sur lequel la méthode est appelée.
move(type, compteur)	réduit l'objet TextRange donné ou déplace l'intervalle vide par le nombre compteur spécifié.
moveEnd(Unité, Compteur)	change la limite de l'objet TextRange en déplaçant sa position de fin.
moveStart(Unité, Compteur)	change la limite de l'objet TextRange en déplaçant sa position de début.
moveToBookmark()	déplace un signet créé par la méthode getBookmark.
moveToElementText(Elément)	déplace l'intervalle des textes de sorte que les positions de début et de fin de l'intervalle entourent le texte dans l'élément donné.
moveToPoint(x, y)	déplace les positions de début et de fin de l'intervalle de texte aux coordonnées spécifiées.
parentElement()	récupère l'élément parent de l'objet TextRange spécifié. L'élément parent est l'élément qui entoure complètement le texte dans l'intervalle.
pasteHTML(texte_HTML)	colle du texte HTML dans l'objet TextRange en se substituant au texte précédent.
queryCommandEnabled(Commande)	retourne true si la commande a été exécutée avec succès en utilisant la méthode ExecCommand.
queryCommandIndeterm(Commande)	retourne true si la commande spécifiée est dans un état indéterminé.
queryCommandState(Commande)	retourne l'état courant de la commande.
queryCommandSupported(Commande)	retourne true si la commande courante est supportée sur l'ojet TextRange.
queryCommandValue(Commande)	retourne la valeur actuelle de la commande donnée sous forme de chaîne de caractères ou d'une valeur booléenne.
scrollIntoView()	provoque le défilement de l'objet TextRange dans l'affichage en alignant au-dessus ou en bas de la fenêtre.
select()	crée une sélection active sur l'intervalle de texte courant.
setEndPoint(Type, Intervalle)	place le point final d'un intervalle basé sur le point final des autres.

Exemple [voir]

<html>
  <head>
    <script language="JavaScript">
      var n = 0;
      function chercheSurPage(chaine)
      {
        if (chaine == "")
        return false;
        if (document.layers)
        {
          if (!window.find(chaine))
            while(window.find(chaine, false, true))
              n++;
          else
            n++;
          if (n == 0)
            alert("Ce mot clé ne se trouve pas sur la page.");
        }
        if (document.all)
        {
          var texte = window.document.body.createTextRange();
          for (var i = 0; i <= n && (var ok = texte.findText(chaine)) != false; i++)
          {
            texte.moveStart("character", 1);
            texte.moveEnd("textedit");
          }
          if (ok)
          {
            texte.moveStart("character", -1);
            texte.findText(chaine);
            texte.select();
            texte.scrollIntoView();
            n++;
          }
          else
          {
            if (n > 0)
            {
              n = 0;
              chercheSurPage(chaine);
            }
            else
              alert("Ce mot clé ne se trouve pas sur la page.");
          }
        }
        return false;
      }
    </script>
  </head>
  <body>
    <form name="recherche" 
           onsubmit="return chercheSurPage(this.motcle.value);">
      <input name="motcle" type="text" size=15 onchange="n = 0;">
      <input type="submit" value="Rechercher">
    </form>
    ...
  </body>
</html>

En savoir plus :