Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

Introduzione

L'oggetto Range rappresenta una parte di un documento, che può contenere nodi e parti di nodi testuali del documento dato.

Un range può essere creato usando il metodo createRange dell'oggetto document. Gli oggetti Range possono essere ottenuti anche usando il metodo getRangeAt dell'oggetto selection.

Proprietà

collapsed
Restituisce un booleano che indica se i punti d'inizio e di fine del range sono nella stessa posizione.
commonAncestorContainer
Restituisce il nodo più interno che contiene i nodi startContainer e endContainer.
endContainer
Restituisce il nodo nel quale il Range finisce.
endOffset
Restituisce un numero che rappresenta il punto preciso in cui il Range finisce, all'interno di endContainer.
startContainer
Restituisce il nodo nel quale il Range inizia.
startOffset
Restituisce un numero che rappresenta il punto preciso in cui il Range inizia, all'interno di startContainer.

Metodi

Metodi di posizionamento

Questi metodi impostano i punti di inizio e di fine di un range.

setStart
Imposta la posizione iniziale di un Range.
setEnd
Setta la posizione finale di un Range.
setStartBefore
Setta la posizione iniziale di un Range nel nodo precedente a quello indicato.
setStartAfter
Setta la posizione iniziale di un Range nel nodo successivo a quello indicato.
setEndBefore
Setta la posizione finale di un Range nel nodo precedente a quello indicato.
setEndAfter
Setta la posizione finale di un Range nel nodo successivo a quello indicato.
selectNode
Inserisce all'interno di un Range uno specifico nodo e il suo contenuto.
selectNodeContents
Inserisce all'interno di un Range esclusivamente il contenuto di uno specifico nodo.
collapse
Collassa un Range in uno dei punti estremi.

Metodi per modificare un Range

Questi metodi prendono i nodi da un range e ne modificano i contenuti.

cloneContents
Restituisce un frammento di documento copiando i nodi da un Range.
deleteContents
Rimuove dal documento i contenuti di un Range.
extractContents
Muove i contenuti di un Range dall'albero del documento in un frammento del documento.
insertNode
Inserisce un nodo all'inizio di un Range.
surroundContents
Muove il contenuto di un Range in un nuovo nodo.

Altri metodi

compareBoundaryPoints
Compara i punti estremi di due Range.
cloneRange
Restituisce un oggetto Range con i punti estremi identici al Range clonato.
detach
Rilascia un Range dall'uso, per migliorare le performance.
toString
Restituisce il testo di un Range.

Metodi proprietari di Gecko

Questa sezione descrive metodi di Range implementati in Gecko ma che non fanno parte delle specifiche DOM del W3C.

compareNode (obsoleto)
Restituisce una costante che rappresenta se il nodo viene prima, dopo o dentro il Range.
comparePoint
Restituisce -1, 0, o 1 per indicare se il punto viene prima, dentro o dopo il range.
createContextualFragment
Restituisce un frammento di documento creato a partire da una data stringa di codice.
intersectsNode (obsoleto)
Restituisce un booleano che indica se il nodo dato interseca il range.
isPointInRange
Restituisce un booleano che indica se il punto dato è interno al range.

Tag del documento e collaboratori

 Hanno collaborato alla realizzazione di questa pagina: teoli, soumya, Federico, Todarogiovanni, DaViD83
 Ultima modifica di: soumya,