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.