Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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().

AbstractRange Range

Constructeur

Range()

Retourne un objet Range avec le Document global comme début et fin.

Propriétés d'instance

Hérite également des propriétés de son interface parente, AbstractRange.

Range.commonAncestorContainer Lecture seule

Retourne le nœud le plus profond qui contient les nœuds startContainer et endContainer.

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 Range avec une autre Range.

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 DocumentFragment en copiant les nœuds d'une Range.

Range.cloneRange()

Retourne un objet Range avec des points de terminaison identiques à ceux de la Range clonée.

Range.createContextualFragment()

Retourne un objet DocumentFragment créé à partir d'une chaîne de caractères de code donnée.

Range.deleteContents()

Supprime le contenu d'une Range du Document.

Range.detach()

Ne fait rien. Conservé pour la compatibilité.

Range.extractContents()

Déplace le contenu d'une Range de l'arbre du document vers un DocumentFragment.

Range.getBoundingClientRect()

Retourne un objet DOMRect qui englobe l'intégralité du contenu de la Range ; cela correspond à l'union de tous les rectangles retournés par Range.getClientRects().

Range.getClientRects()

Retourne une liste d'objets DOMRect qui agrègent les résultats de Element.getClientRects() pour tous les éléments dans la Range.

Range.isPointInRange()

Retourne un booléen (boolean) indiquant si le point donné se trouve dans la Range.

Range.insertNode()

Insère un nœud (Node) au début d'une Range.

Range.intersectsNode()

Retourne un booléen (boolean) indiquant si le nœud donné intersecte la Range.

Range.selectNode()

Définit la Range pour contenir le nœud (Node) et son contenu.

Range.selectNodeContents()

Définit la Range pour 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 Range par rapport à un autre nœud (Node).

Range.setEndBefore()

Définit la position de fin d'une Range par rapport à un autre nœud (Node).

Range.setStartAfter()

Définit la position de début d'une Range par rapport à un autre nœud (Node).

Range.setStartBefore()

Définit la position de début d'une Range par rapport à un autre nœud (Node).

Range.surroundContents()

Déplace le contenu d'une Range dans 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

Compatibilité des navigateurs

Voir aussi