From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/range/index.md | 103 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 files/fr/web/api/range/index.md (limited to 'files/fr/web/api/range/index.md') diff --git a/files/fr/web/api/range/index.md b/files/fr/web/api/range/index.md new file mode 100644 index 0000000000..a17b45d829 --- /dev/null +++ b/files/fr/web/api/range/index.md @@ -0,0 +1,103 @@ +--- +title: range +slug: Web/API/Range +translation_of: Web/API/Range +--- +

{{ ApiRef() }}

+ +

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 startContainer et endContainer.
+
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 Range avec 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 {{ Obsolete_inline() }}
+
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 {{ Obsolete_inline() }}
+
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.
+
\ No newline at end of file -- cgit v1.2.3-54-g00ecf