blob: 9ff0663ee0f132dc6a0c7f717fcb058f73bba361 (
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
---
title: range
slug: Web/API/Range
tags:
- DOM
- Gecko
- Reference_del_DOM_di_Gecko
- SezioneIncompleta
- Tutte_le_categorie
translation_of: Web/API/Range
---
<p>{{ ApiRef() }}</p>
<h3 id="Introduzione" name="Introduzione">Introduzione</h3>
<p>L'oggetto <code>Range</code> rappresenta una parte di un documento, che può contenere nodi e parti di nodi testuali del documento dato.</p>
<p>Un range può essere creato usando il metodo <code><a href="it/DOM/document.createRange">createRange</a></code> dell'oggetto <code><a href="it/DOM/document">document</a></code>. Gli oggetti Range possono essere ottenuti anche usando il metodo <code><a href="it/DOM/Selection/getRangeAt">getRangeAt</a></code> dell'oggetto <code><a href="it/DOM/Selection">selection</a></code>.</p>
<h3 id="Propriet.C3.A0" name="Propriet.C3.A0">Proprietà</h3>
<dl>
<dt>
<a href="it/DOM/range.collapsed">collapsed</a></dt>
<dd>
Restituisce un booleano che indica se i punti d'inizio e di fine del range sono nella stessa posizione.</dd>
<dt>
<a href="it/DOM/range.commonAncestorContainer">commonAncestorContainer</a></dt>
<dd>
Restituisce il nodo più interno che contiene i nodi startContainer e endContainer.</dd>
<dt>
<a href="it/DOM/range.endContainer">endContainer</a></dt>
<dd>
Restituisce il nodo nel quale il Range finisce.</dd>
<dt>
<a href="it/DOM/range.endOffset">endOffset</a></dt>
<dd>
Restituisce un numero che rappresenta il punto preciso in cui il Range finisce, all'interno di endContainer.</dd>
<dt>
<a href="it/DOM/range.startContainer">startContainer</a></dt>
<dd>
Restituisce il nodo nel quale il Range inizia.</dd>
<dt>
<a href="it/DOM/range.startOffset">startOffset</a></dt>
<dd>
Restituisce un numero che rappresenta il punto preciso in cui il Range inizia, all'interno di startContainer.</dd>
</dl>
<h3 id="Metodi" name="Metodi">Metodi</h3>
<h4 id="Metodi_di_posizionamento" name="Metodi_di_posizionamento">Metodi di posizionamento</h4>
<p>Questi metodi impostano i punti di inizio e di fine di un range.</p>
<dl>
<dt>
<a href="it/DOM/range.setStart">setStart</a></dt>
<dd>
Imposta la posizione iniziale di un Range.</dd>
<dt>
<a href="it/DOM/range.setEnd">setEnd</a></dt>
<dd>
Setta la posizione finale di un Range.</dd>
<dt>
<a href="it/DOM/range.setStartBefore">setStartBefore</a></dt>
<dd>
Setta la posizione iniziale di un Range nel nodo precedente a quello indicato.</dd>
<dt>
<a href="it/DOM/range.setStartAfter">setStartAfter</a></dt>
<dd>
Setta la posizione iniziale di un Range nel nodo successivo a quello indicato.</dd>
<dt>
<a href="it/DOM/range.setEndBefore">setEndBefore</a></dt>
<dd>
Setta la posizione finale di un Range nel nodo precedente a quello indicato.</dd>
<dt>
<a href="it/DOM/range.setEndAfter">setEndAfter</a></dt>
<dd>
Setta la posizione finale di un Range nel nodo successivo a quello indicato.</dd>
<dt>
<a href="it/DOM/range.selectNode">selectNode</a></dt>
<dd>
Inserisce all'interno di un Range uno specifico nodo e il suo contenuto.</dd>
<dt>
<a href="it/DOM/range.selectNodeContents">selectNodeContents</a></dt>
<dd>
Inserisce all'interno di un Range esclusivamente il contenuto di uno specifico nodo.</dd>
<dt>
<a href="it/DOM/range.collapse">collapse</a></dt>
<dd>
Collassa un Range in uno dei punti estremi.</dd>
</dl>
<h4 id="Metodi_per_modificare_un_Range" name="Metodi_per_modificare_un_Range">Metodi per modificare un Range</h4>
<p>Questi metodi prendono i nodi da un range e ne modificano i contenuti.</p>
<dl>
<dt>
<a href="it/DOM/range.cloneContents">cloneContents</a></dt>
<dd>
Restituisce un frammento di documento copiando i nodi da un Range.</dd>
<dt>
<a href="it/DOM/range.deleteContents">deleteContents</a></dt>
<dd>
Rimuove dal documento i contenuti di un Range.</dd>
<dt>
<a href="it/DOM/range.extractContents">extractContents</a></dt>
<dd>
Muove i contenuti di un Range dall'albero del documento in un frammento del documento.</dd>
<dt>
<a href="it/DOM/range.insertNode">insertNode</a></dt>
<dd>
Inserisce un nodo all'inizio di un Range.</dd>
<dt>
<a href="it/DOM/range.surroundContents">surroundContents</a></dt>
<dd>
Muove il contenuto di un Range in un nuovo nodo.</dd>
</dl>
<h4 id="Altri_metodi" name="Altri_metodi">Altri metodi</h4>
<dl>
<dt>
<a href="it/DOM/range.compareBoundaryPoints">compareBoundaryPoints</a></dt>
<dd>
Compara i punti estremi di due Range.</dd>
<dt>
<a href="it/DOM/range.cloneRange">cloneRange</a></dt>
<dd>
Restituisce un oggetto Range con i punti estremi identici al Range clonato.</dd>
<dt>
<a href="it/DOM/range.detach">detach</a></dt>
<dd>
Rilascia un Range dall'uso, per migliorare le performance.</dd>
<dt>
<a href="it/DOM/range.toString">toString</a></dt>
<dd>
Restituisce il testo di un Range.</dd>
</dl>
<h4 id="Metodi_proprietari_di_Gecko" name="Metodi_proprietari_di_Gecko">Metodi proprietari di Gecko</h4>
<p>Questa sezione descrive metodi di Range implementati in Gecko ma che non fanno parte delle specifiche DOM del W3C.</p>
<dl>
<dt>
<a href="it/DOM/range.compareNode">compareNode</a> (obsoleto)</dt>
<dd>
Restituisce una costante che rappresenta se il nodo viene prima, dopo o dentro il Range.</dd>
<dt>
<a href="it/DOM/range.comparePoint">comparePoint</a></dt>
<dd>
Restituisce -1, 0, o 1 per indicare se il punto viene prima, dentro o dopo il range.</dd>
<dt>
<a href="it/DOM/range.createContextualFragment">createContextualFragment</a></dt>
<dd>
Restituisce un frammento di documento creato a partire da una data stringa di codice.</dd>
<dt>
<a href="it/DOM/range.intersectsNode">intersectsNode</a> (obsoleto)</dt>
<dd>
Restituisce un booleano che indica se il nodo dato interseca il range.</dd>
<dt>
<a href="it/DOM/range.isPointInRange">isPointInRange</a></dt>
<dd>
Restituisce un booleano che indica se il punto dato è interno al range.</dd>
</dl>
|
