From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/range/index.html | 111 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 files/fr/web/api/range/index.html (limited to 'files/fr/web/api/range/index.html') diff --git a/files/fr/web/api/range/index.html b/files/fr/web/api/range/index.html new file mode 100644 index 0000000000..c42a83b4ea --- /dev/null +++ b/files/fr/web/api/range/index.html @@ -0,0 +1,111 @@ +--- +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.
+
+ +

Liens Interwikis

+ +

 

+ +
 
+ +

{{ languages( { "en": "en/DOM/range", "es": "es/DOM/range", "ja": "ja/DOM/range", "pl": "pl/DOM/range" } ) }}

-- cgit v1.2.3-54-g00ecf