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.