CKTIS / JavaScript
Range: contenedor común, desplazamientos y estado colapsado
Lee los límites de un rango del DOM, encuentra su nodo común más cercano y comprueba si ambos límites señalan el mismo punto.
Versión: Current web platform; runtime support varies
Sintaxis
range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsedRange es una interfaz del DOM, no una parte de ECMAScript 2024. La disponibilidad de estas propiedades depende de la implementación del DOM en el entorno de ejecución, no de la edición de ECMAScript. No des por hecho que existen en un entorno sin DOM. Cada límite es un par formado por un nodo y un desplazamiento. Lee startOffset junto con startContainer, y endOffset junto con endContainer.
Un desplazamiento es una posición que se cuenta a partir de cero, no el índice del último carácter incluido. En un nodo CharacterData como Text, cuenta las unidades de código UTF-16 anteriores al límite, no los caracteres que percibe el usuario. En un contenedor como Element, cuenta los nodos hijos directos anteriores al límite, incluidos los de texto y los comentarios, como en childNodes. 0 queda antes de la primera unidad o el primer hijo; la longitud total queda después del último.
commonAncestorContainer devuelve el nodo más profundo que, para cada contenedor de límite, es el propio contenedor o uno de sus antecesores. Si los dos contenedores son el mismo nodo, devuelve ese nodo, incluso si es Text. collapsed solo vale true si ambos límites tienen el mismo nodo y el mismo desplazamiento. No basta con que los desplazamientos coincidan si los nodos son distintos.
Las cuatro propiedades de instancia son de solo lectura; startOffset, endOffset y collapsed se heredan de AbstractRange. Usa setStart() y setEnd() para mover los límites. collapse(true) colapsa el rango al inicio; collapse(false) o collapse() lo colapsa al final. Un Range es dinámico: los cambios en el DOM pueden ajustar sus límites.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>DOM Range boundary points</title>
<script>
{
const container = document.createElement('div');
const text = document.createTextNode('A😀B');
container.appendChild(text);
const range = document.createRange();
range.setStart(text, 3);
range.setEnd(container, 1);
const logRange = (expectedAncestor) => {
console.log(JSON.stringify([
range.commonAncestorContainer === expectedAncestor,
range.startOffset,
range.endOffset,
range.collapsed,
range.toString(),
]));
};
logRange(container);
range.collapse(true);
logRange(text);
}
</script>Resultado
[true,3,1,false,"B"] [true,3,3,true,""]
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba la salida en la consola de desarrollo. El desplazamiento `3` en el nodo de texto queda justo después del emoji, que ocupa dos unidades de código UTF-16. El desplazamiento `1` en el elemento queda después de su único hijo. Por tanto, el rango contiene `B`. Tras `collapse(true)`, ambos límites quedan en el desplazamiento `3` del nodo de texto, que pasa a ser el contenedor común.
Lecciones relacionadas
- JavaScript · Lección 33 · Intermedio · Versión: 3