DOM:range
De MDC
Esta página está traduciéndose a partir del artículo DOM:range, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción
Tabla de contenidos |
[editar] Introducción
El objeto rango 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 documento. Los objetos rango pueden ser recuperados usando el método getRangeAt del objeto selección.
[editar] 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
Rangeen elendContainer. - startContainer
- Devuelve el nodo dentro del cual comienza el rango.
- startOffset
- Devuelve un número representando donde empieza el
Rangeen elendContainer.
[editar] Métodos
[editar] 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.
[editar] 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.
[editar] 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.
[editar] 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.