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 el endContainer.

startContainer

Devuelve el nodo dentro del cual comienza el rango.

startOffset

Devuelve un número representando donde empieza el Range en el endContainer.

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.