range

  • Raccourci de la révision : DOM/range
  • Titre de la révision : range
  • ID de la révision : 188476
  • Créé :
  • Créateur : Fredchat
  • Version actuelle ? Non
  • Commentaire /* Corrections de modèles */

Contenu de la révision

{{template.Traduction_en_cours("DOM:range")}}

Introduction

L'objet Range (gamme) représente un fragment de document qui peut contenir des noeuds (nodes) et des noeuds de partis de text dans un document donné.

Une gamme peut être crée en utilisant la méthode createRange de l'objet document. Les objets gamme peuvent également être récupéré en utilisant la methode getRangeAt de l'objet selection.

{{wiki.template('Traduction_à_relire')}}

Propriétés

collapsed
Renvoi un booléen qui indique si le point de départ et le point finale de la gamme (range) sont à une même position.
commonAncestorContainer
Renvoi le noeud le plus profond qui contient les noeuds de startContainer de départ et endContainer de fin.
endContainer
Renvoi le noeud là où la gamme se termine.
endOffset
Renvoi un numero représentant là où dans le endContainer la gamme se termine.
startContainer
Renvoi le noeud là où la gamme débute.
startOffset
Renvoi un numero représentant là où dans le startContainer la gamme débute.

Méthodes

Méthodes de positionnement

Ces méthodes mettent en place les points de départ et d'arrivé d'une Gamme (Range)

setStart
Règle le point de départ d'une gamme.
setEnd
Règle le point finale d'une gamme.
setStartBefore
Règle la position de départ d'une gamme relatif à un autre noeud.
setStartAfter
Règle la position de départ d'une gamme relatif à un autre noeud.
setEndBefore
Règle la position finale d'une gamme relatif à un autre noeud.
setEndAfter
Règle la position finale d'une gamme relatif à un autre noeud.
selectNode
Règle la gamme afin de contenir le noeud et son contenu.
selectNodeContents
Règle la gamme afin de contenir le contenu d'un noeud.
collapse
Fermer la gamme en un de ses points frontière.

Méthodes de Modifications

Ces Methodes recupèrent les noeuds d'une gamme et modifient le contenu d'une gamme.

cloneContents
Renvoi un fragment de document copiant les noeuds d'une gamme.
deleteContents
Supprime du document le contenu d'une gamme.
extractContents
Déplace le contenu d'une gamme, de l'arbre du document dans un fragment de document.
insertNode
Insérer un noeud au début d'une gamme.
surroundContents
Déplace le contenu d'une gamme dans un nouveau noeud.

Autres Méthodes

compareBoundaryPoints
Compare les points frontière de deux gammes.
cloneRange
Renvoi un objet de gamme (Range object) avec des points frontière identique à la gamme cloné.
detach
Relâche l'utilisation de la gamme afin d'améliorer la performance.
toString
Renvoi le texte de la gamme.

Les Méthodes Gecko

Cette section décrit les méthodes de Gamme qui sont particulières à Mozilla et ne font pas à partie des caractéristiques de W3C DOM.

compareNode {{template.Obsolete_inline()}}
Renvoie une constante qui représente si le noeud est avant, après, dans ou autour de la gamme.
comparePoint
Renvoi -1, 0, ou 1 indiquant si le point se trouve avant, dans ou après la gamme.
createContextualFragment
Renvoi un fragment de document crée à partir d'une chaine de code.
intersectsNode {{template.Obsolete_inline()}}
Renvoie un booléen indiquant si un noeud donné à une intersection avec la gamme.
isPointInRange
Renvoi un booléen indiquant si le point donné est dans la gamme.
{{ wiki.languages( { "en": "en/DOM/range" } ) }}

Source de la révision

<p>{{template.Traduction_en_cours("DOM:range")}}
</p>
<h3 name="Introduction"> Introduction </h3>
<p>L'objet <code>Range</code> (gamme) représente un  fragment de document qui peut contenir des noeuds (nodes) et des noeuds de partis de text dans un document donné.
</p><p>Une gamme peut être crée en utilisant la méthode <a href="fr/DOM/document.createRange">createRange</a> de l'objet <a href="fr/DOM/document">document</a>. Les objets gamme peuvent également être récupéré en utilisant la methode <a href="fr/DOM/Selection/getRangeAt">getRangeAt</a>  de l'objet <a href="fr/DOM/Selection">selection</a>.
</p><p>{{wiki.template('Traduction_à_relire')}}
</p>
<h3 name="Propri.C3.A9t.C3.A9s"> Propriétés </h3>
<dl><dt><a href="fr/DOM/range.collapsed">collapsed</a>
</dt><dd>Renvoi un booléen qui indique si le point de départ et le point finale de la gamme (range) sont à une même position.
</dd><dt><a href="fr/DOM/range.commonAncestorContainer">commonAncestorContainer</a>
</dt><dd>Renvoi le noeud le plus profond qui contient les noeuds de startContainer de départ  et endContainer de fin.
</dd><dt><a href="fr/DOM/range.endContainer">endContainer</a>
</dt><dd>Renvoi le noeud là où la gamme se termine.
</dd><dt><a href="fr/DOM/range.endOffset">endOffset</a>
</dt><dd>Renvoi un numero représentant là où dans le endContainer la gamme se termine.
</dd><dt><a href="fr/DOM/range.startContainer">startContainer</a>
</dt><dd>Renvoi le noeud là où la gamme débute. 
</dd><dt><a href="fr/DOM/range.startOffset">startOffset</a>
</dt><dd>Renvoi un numero représentant là où dans le startContainer la gamme débute.
</dd></dl>
<h3 name="M.C3.A9thodes"> Méthodes </h3>
<h4 name="M.C3.A9thodes_de_positionnement"> Méthodes de positionnement </h4>
<p>Ces méthodes mettent en place les points de départ et d'arrivé d'une Gamme (Range)
</p>
<dl><dt><a href="fr/DOM/range.setStart">setStart</a>
</dt><dd>Règle le point de départ d'une gamme.
</dd><dt><a href="fr/DOM/range.setEnd">setEnd</a>
</dt><dd>Règle le point finale d'une gamme.
</dd><dt><a href="fr/DOM/range.setStartBefore">setStartBefore</a>
</dt><dd>Règle la position de départ d'une gamme relatif à un autre noeud.
</dd><dt><a href="fr/DOM/range.setStartAfter">setStartAfter</a>
</dt><dd>Règle la position de départ d'une gamme relatif à un autre noeud.
</dd><dt><a href="fr/DOM/range.setEndBefore">setEndBefore</a>
</dt><dd>Règle la position finale d'une gamme relatif à un autre noeud.
</dd><dt><a href="fr/DOM/range.setEndAfter">setEndAfter</a>
</dt><dd>Règle la position finale d'une gamme relatif à un autre noeud.
</dd><dt><a href="fr/DOM/range.selectNode">selectNode</a>
</dt><dd>Règle la gamme afin de contenir le noeud et son contenu.
</dd><dt><a href="fr/DOM/range.selectNodeContents">selectNodeContents</a>
</dt><dd>Règle la gamme afin de contenir le contenu d'un noeud.
</dd><dt><a href="fr/DOM/range.collapse">collapse</a>
</dt><dd>Fermer la gamme en un de ses points frontière.
</dd></dl>
<h4 name="M.C3.A9thodes_de_Modifications"> Méthodes de Modifications   </h4>
<p>Ces Methodes recupèrent les noeuds d'une gamme  et modifient le contenu d'une gamme.
</p>
<dl><dt><a href="fr/DOM/range.cloneContents">cloneContents</a>
</dt><dd>Renvoi un fragment de document copiant les noeuds d'une gamme.
</dd><dt><a href="fr/DOM/range.deleteContents">deleteContents</a>
</dt><dd>Supprime du document le contenu d'une gamme.
</dd><dt><a href="fr/DOM/range.extractContents">extractContents</a>
</dt><dd>Déplace le contenu d'une gamme, de l'arbre du document dans un fragment de document. 
</dd><dt><a href="fr/DOM/range.insertNode">insertNode</a>
</dt><dd>Insérer un noeud au début d'une gamme.
</dd><dt><a href="fr/DOM/range.surroundContents">surroundContents</a>
</dt><dd>Déplace le contenu d'une gamme dans un nouveau noeud.
</dd></dl>
<h4 name="Autres_M.C3.A9thodes"> Autres Méthodes </h4>
<dl><dt><a href="fr/DOM/range.compareBoundaryPoints">compareBoundaryPoints</a>
</dt><dd>Compare les points frontière de deux gammes.
</dd><dt><a href="fr/DOM/range.cloneRange">cloneRange</a>
</dt><dd>Renvoi un objet de gamme (Range object) avec des points frontière identique à la gamme cloné.
</dd><dt><a href="fr/DOM/range.detach">detach</a>
</dt><dd>Relâche l'utilisation de la gamme afin d'améliorer la performance.
</dd><dt><a href="fr/DOM/range.toString">toString</a>
</dt><dd>Renvoi le texte de la gamme.
</dd></dl>
<h4 name="Les_M.C3.A9thodes_Gecko"> Les Méthodes Gecko </h4>
<p>Cette section décrit les méthodes de Gamme qui sont particulières à Mozilla et ne font pas à partie des caractéristiques de W3C DOM.
</p>
<dl><dt><a href="fr/DOM/range.compareNode">compareNode</a> {{template.Obsolete_inline()}}
</dt><dd>Renvoie une constante qui représente si le noeud est avant, après, dans ou autour de la gamme.
</dd><dt><a href="fr/DOM/range.comparePoint">comparePoint</a>
</dt><dd>Renvoi -1, 0, ou 1 indiquant si le point se trouve avant, dans ou après la gamme.
</dd><dt><a href="fr/DOM/range.createContextualFragment">createContextualFragment</a>
</dt><dd>Renvoi un fragment de document crée à partir d'une chaine de code. 
</dd><dt><a href="fr/DOM/range.intersectsNode">intersectsNode</a> {{template.Obsolete_inline()}}
</dt><dd>Renvoie un booléen indiquant si un noeud donné à une intersection avec la gamme.
</dd><dt><a href="fr/DOM/range.isPointInRange">isPointInRange</a>
</dt><dd>Renvoi un booléen indiquant si le point donné est dans la gamme.
</dd></dl>
{{ wiki.languages( { "en": "en/DOM/range" } ) }}
Revenir à cette révision