Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
range
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Introduction
L'objetRange (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éthodecreateRange de l'objetdocument. Les objets range peuvent également être récupérés en utilisant la méthodegetRangeAt de l'objetselection.
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.
- compareNodeObsolète
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é.
- intersectsNodeObsolète
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.