range
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Introducción
El objeto Range
representa un fragmento de un documento que puede contener nodos y partes de nodos de texto en un documento dado.
Un rango puede ser creado usando el método createRange
del objeto document
. Los objetos rango pueden ser recuperados usando el método getRangeAt
del objeto Selection
.
Propiedades
- collapsed
-
Devuelve un valor booleano indicando si los puntos de inicio y fin están en la misma posición.
- commonAncestorContainer
-
Devuelve el nodo más profundo que contiene los nodos startContainer y endContainer.
- endContainer
-
Devuelve el nodo dentro del cual termina el rango.
- endOffset
-
Devuelve un número representando donde termina el
Range
en elendContainer
. - startContainer
-
Devuelve el nodo dentro del cual comienza el rango.
- startOffset
-
Devuelve un número representando donde empieza el
Range
en elendContainer
.
Métodos
Métodos de ubicación
Estos métodos definen el punto de inicio y fin de un rango.
- setStart
-
Define la posición inicial de un rango.
- setEnd
-
Define la posición final de un rango.
- setStartBefore
-
Define la posición inicial de un rango relativa a otro nodo.
- setStartAfter
-
Define la posición inicial de un rango relativa a otro nodo.
- setEndBefore
-
Define la posición final de un rango relativa a otro nodo.
- setEndAfter
-
Define la posición final de un rango relativa a otro nodo.
- selectNode
-
Define el rango a contener el nodo y sus contenidos.
- selectNodeContents
-
Define el rango a contener los contenidos de un nodo.
- collapse
-
Pliega el Rango a uno de sus puntos límite.
Editando métodos
Estos métodos recuperan nodos de un rango y modifican los contenidos de un rango.
- cloneContents
-
Devuelve un fragmento de documento copiando los nodos de un rango.
- deleteContents
-
Elimina del documento los contenidos de un rango.
- extractContents
-
Mueve los contenidos de un rango del árbol de documento a un fragmento del documento.
- insertNode
-
Inserta un nodo al comienzo de un rango.
- surroundContents
-
Mueve el contenido de un rango a un nodo nuevo.
Otros métodos
- compareBoundaryPoints
-
Compara los puntos límite de dos rangos.
- cloneRange
-
Devuelve un objeto rango con puntos límites idénticos al rango clonado.
- detach
-
Libera el Rango desde el uso para mejorar el rendimiento.
- toString
-
Devuelve el texto del rango.
Métodos de Gecko
Esta sección describe métodos de Range
que son particulares a Mozilla y no son parte de las especificaciones DOM W3C.
- compareNode Obsoleto
-
Devuelve una constante representando si el nodo está antes, después, dentro o alrededor del rango.
- comparePoint
-
Devuelve -1, 0, or 1 indicando si el punto ocurre antes, dentro o después del rango.
- createContextualFragment
-
Devuelve un fragmenteo de documento creado de un texto de código.
- intersectsNode Obsoleto
-
Devuelve un valor boleano verdadero si el nodo dado intersecta el rango.
- isPointInRange
-
Devuelve un valor boleano verdadero indicando si el punto dado está en el rango.