Introduction
L'objet Range (littéralement : "étendue" ou "portée", ici : "segment") représente un fragment de document qui peut contenir des nœuds et des parties de nœuds texte dans un document donné.
Un segment peut être crée en utilisant la méthode createRange de l'objet document. Les objets range peuvent également être récupérés en utilisant la méthode getRangeAt de l'objet selection.
Propriétés
- collapsed
- Renvoie un booléen indiquant si le point de départ et le point final du segment sont confondus.
- commonAncestorContainer
- Renvoie le nœud le plus profond qui contient à la fois les nœuds
startContaineretendContainer. - endContainer
- Renvoie le nœud dans lequel le segment se termine.
- endOffset
- Renvoie un nombre représentant l'endroit où le segment se termine dans
endContainer. - startContainer
- Renvoie le nœud dans lequel le segment débute.
- startOffset
- Renvoie un nombre représentant l'endroit où le segment débute dans
startContainer.
Méthodes
Méthodes de positionnement
Ces méthodes permettent de définir le début et la fin d'un segment.
- setStart
- Définit le point de départ d'un segment.
- setEnd
- Définit le point final d'un segment.
- setStartBefore
- Définit le point de départ d'un segment relativement à un autre nœud.
- setStartAfter
- Définit le point de départ d'un segment relativement à un autre nœud.
- setEndBefore
- Définit le point final d'un segment relativement à un autre nœud.
- setEndAfter
- Définit le point final d'un segment relativement à un autre nœud.
- selectNode
- Le contenu du segment devient le nœud et son contenu.
- selectNodeContents
- le contenu du segment devient le contenu du nœud.
- collapse
- Replie le segment sur l'un de ses points frontières.
Méthodes de modification
Ces méthodes recupèrent les nœuds d'un segment et modifient le contenu d'un segment.
- cloneContents
- Renvoie un fragment de document où sont copiés les nœuds d'un segment.
- deleteContents
- Supprime du document le contenu d'un segment.
- extractContents
- Déplace le contenu d'un segment, de l'arbre du document vers un fragment de document.
- insertNode
- Insère un nœud au début d'un segment.
- surroundContents
- Déplace le contenu d'un segment dans un nouveau nœud.
Autres méthodes
- compareBoundaryPoints
- Compare les points frontières de deux segments.
- cloneRange
- Renvoie un objet
Rangeavec des points frontières identiques à ceux du segment cloné. - detach
- Supprime le segment afin d'améliorer la performance.
- toString
- Renvoie le texte du segment.
Les méthodes Gecko
Cette section décrit les méthodes de range qui sont particulières à Mozilla et ne font pas partie des spécifications DOM W3C.
- compareNode
- Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe le segment.
- comparePoint
- Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans le segment.
- createContextualFragment
- Renvoie un fragment de document créé à partir d'un morceau de code donné.
- intersectsNode
- Renvoie un booléen indiquant si un nœud donné a une intersection avec le segment.
- isPointInRange
- Renvoie un booléen indiquant si le point donné est dans le segment.
Liens Interwikis
Étiquettes et contributeurs liés au document
Dernière mise à jour par :
stefmaster,