blob: ab3abd3ad5961d11f0f53eb0285f99726300d012 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
---
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](/fr/docs/Web/API/document/createRange) de l'objet [document](/fr/docs/Web/API/document). Les objets range peuvent également être récupérés en utilisant la méthode [getRangeAt](/fr/docs/Web/API/Selection/getRangeAt) de l'objet [selection](/fr/docs/Web/API/Selection).
### Propriétés
- [collapsed](/fr/docs/Web/API/range/collapsed)
- : Renvoie un booléen indiquant si le point de départ et le point final du segment sont confondus.
- [commonAncestorContainer](/fr/docs/Web/API/range/commonAncestorContainer)
- : Renvoie le nœud le plus profond qui contient à la fois les nœuds `startContainer` et `endContainer`.
- [endContainer](/fr/docs/Web/API/range/endContainer)
- : Renvoie le nœud dans lequel le segment se termine.
- [endOffset](/fr/docs/Web/API/range/endOffset)
- : Renvoie un nombre représentant l'endroit où le segment se termine dans `endContainer`.
- [startContainer](/fr/docs/Web/API/range/startContainer)
- : Renvoie le nœud dans lequel le segment débute.
- [startOffset](/fr/docs/Web/API/range/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](/fr/docs/Web/API/range/setStart)
- : Définit le point de départ d'un segment.
- [setEnd](/fr/docs/Web/API/range/setEnd)
- : Définit le point final d'un segment.
- [setStartBefore](/fr/docs/Web/API/range/setStartBefore)
- : Définit le point de départ d'un segment relativement à un autre nœud.
- [setStartAfter](/fr/docs/Web/API/range/setStartAfter)
- : Définit le point de départ d'un segment relativement à un autre nœud.
- [setEndBefore](/fr/docs/Web/API/range/setEndBefore)
- : Définit le point final d'un segment relativement à un autre nœud.
- [setEndAfter](/fr/docs/Web/API/range/setEndAfter)
- : Définit le point final d'un segment relativement à un autre nœud.
- [selectNode](/fr/docs/Web/API/range/selectNode)
- : Le contenu du segment devient le nœud et son contenu.
- [selectNodeContents](/fr/docs/Web/API/range/selectNodeContents)
- : le contenu du segment devient le contenu du nœud.
- [collapse](/fr/docs/Web/API/range/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](/fr/docs/Web/API/range/cloneContents)
- : Renvoie un fragment de document où sont copiés les nœuds d'un segment.
- [deleteContents](/fr/docs/Web/API/range/deleteContents)
- : Supprime du document le contenu d'un segment.
- [extractContents](/fr/docs/Web/API/range/extractContents)
- : Déplace le contenu d'un segment, de l'arbre du document vers un fragment de document.
- [insertNode](/fr/docs/Web/API/range/insertNode)
- : Insère un nœud au début d'un segment.
- [surroundContents](/fr/docs/Web/API/range/surroundContents)
- : Déplace le contenu d'un segment dans un nouveau nœud.
#### Autres méthodes
- [compareBoundaryPoints](/fr/docs/Web/API/range/compareBoundaryPoints)
- : Compare les points frontières de deux segments.
- [cloneRange](/fr/docs/Web/API/range/cloneRange)
- : Renvoie un objet `Range` avec des points frontières identiques à ceux du segment cloné.
- [detach](/fr/docs/Web/API/range/detach)
- : Supprime le segment afin d'améliorer la performance.
- [toString](/fr/docs/Web/API/range/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](/fr/docs/Web/API/range/compareNode) {{ Obsolete_inline() }}
- : Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe le segment.
- [comparePoint](/fr/docs/Web/API/range/comparePoint)
- : Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans le segment.
- [createContextualFragment](/fr/docs/Web/API/range/createContextualFragment)
- : Renvoie un fragment de document créé à partir d'un morceau de code donné.
- [intersectsNode](/fr/docs/Web/API/range/intersectsNode) {{ Obsolete_inline() }}
- : Renvoie un booléen indiquant si un nœud donné a une intersection avec le segment.
- [isPointInRange](/fr/docs/Web/API/range/isPointInRange)
- : Renvoie un booléen indiquant si le point donné est dans le segment.
|
