Range
Baseline
Large disponibilité
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.
L'interface Range représente un fragment d'un document qui peut contenir des nœuds et des parties de nœuds texte.
Un segment peut être créé en utilisant la méthode Document.createRange(). Les objets Range peuvent également être récupérés en utilisant la méthode getRangeAt() de l'objet Selection ou la méthode caretRangeFromPoint() de l'objet Document.
Il existe également le constructeur Range().
Constructeur
Propriétés d'instance
Hérite également des propriétés de son interface parente, AbstractRange.
Range.commonAncestorContainerLecture seule-
Retourne le nœud le plus profond qui contient les nœuds
startContaineretendContainer.
Méthodes d'instance
Il n'y a pas de méthodes héritées.
Range.collapse()-
Réduit la
Rangeà l'un de ses points de terminaison. Range.compareBoundaryPoints()-
Compare les points de terminaison de la
Rangeavec une autreRange. Range.compareNode()-
Retourne une constante représentant si le nœud (
Node) est avant, après, à l'intérieur ou entourant la plage. Range.comparePoint()-
Retourne -1, 0 ou 1 indiquant si le point se trouve avant, à l'intérieur ou après la
Range. Range.cloneContents()-
Retourne un objet
DocumentFragmenten copiant les nœuds d'uneRange. Range.cloneRange()-
Retourne un objet
Rangeavec des points de terminaison identiques à ceux de laRangeclonée. Range.createContextualFragment()-
Retourne un objet
DocumentFragmentcréé à partir d'une chaîne de caractères de code donnée. Range.deleteContents()-
Supprime le contenu d'une
RangeduDocument. Range.detach()-
Ne fait rien. Conservé pour la compatibilité.
Range.extractContents()-
Déplace le contenu d'une
Rangede l'arbre du document vers unDocumentFragment. Range.getBoundingClientRect()-
Retourne un objet
DOMRectqui englobe l'intégralité du contenu de laRange; cela correspond à l'union de tous les rectangles retournés parRange.getClientRects(). Range.getClientRects()-
Retourne une liste d'objets
DOMRectqui agrègent les résultats deElement.getClientRects()pour tous les éléments dans laRange. Range.isPointInRange()-
Retourne un booléen (
boolean) indiquant si le point donné se trouve dans laRange. Range.insertNode()-
Insère un nœud (
Node) au début d'uneRange. Range.intersectsNode()-
Retourne un booléen (
boolean) indiquant si le nœud donné intersecte laRange. Range.selectNode()-
Définit la
Rangepour contenir le nœud (Node) et son contenu. Range.selectNodeContents()-
Définit la
Rangepour contenir le contenu d'un nœud (Node). Range.setEnd()-
Définit la position de fin d'une
Range. Range.setStart()-
Définit la position de début d'une
Range. Range.setEndAfter()-
Définit la position de fin d'une
Rangepar rapport à un autre nœud (Node). Range.setEndBefore()-
Définit la position de fin d'une
Rangepar rapport à un autre nœud (Node). Range.setStartAfter()-
Définit la position de début d'une
Rangepar rapport à un autre nœud (Node). Range.setStartBefore()-
Définit la position de début d'une
Rangepar rapport à un autre nœud (Node). Range.surroundContents()-
Déplace le contenu d'une
Rangedans un nouveau nœud (Node). Range.toString()-
Retourne le texte de la
Range.
Spécifications
| Spécification |
|---|
| DOM> # interface-range> |
| DOM Parsing and Serialization> # extensions-to-the-range-interface> |
| CSSOM View Module> # extensions-to-the-range-interface> |