CKTIS / JavaScript
Desplazamiento y sustitución de hijos de un elemento: scrollTop, scrollHeight y replaceChildren()
Lee y establece la posición de desplazamiento, distingue la altura desplazable total de la altura interior visible y sustituye los nodos hijos sin interpretar las cadenas como HTML.
Versión: Current web platform; runtime support varies
Sintaxis
const offset = el.scrollTop;
el.scrollTop = y;
const contentHeight = el.scrollHeight;
const visibleHeight = el.clientHeight;
el.replaceChildren();
el.replaceChildren(node, "text");
el.replaceChildren(...items);scrollTop es el desplazamiento vertical desde el origen, en píxeles CSS. Se puede leer y escribir, y su valor puede tener decimales. Una asignación solicita una posición absoluta, no un movimiento relativo, con el comportamiento auto. Puede tomar valores negativos con flex-direction: column-reverse; el rebote de Safari puede llevarlos temporalmente fuera del intervalo habitual.
scrollHeight es la altura entera y de solo lectura de toda el área desplazable, incluida la parte que queda fuera de la vista. Incluye el relleno y puede incluir los pseudoelementos, pero excluye el borde, el margen y la barra de desplazamiento horizontal. clientHeight mide la altura interior visible. Sin desbordamiento vertical, las dos alturas son iguales.
En un contenedor normal que se desplaza hacia abajo, el.scrollHeight - el.clientHeight aproxima el valor de scrollTop al final. Comprueba si has llegado abajo con Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1, no con ===: las alturas se redondean, pero el desplazamiento puede ser fraccionario. No apliques esa prueba sin cambios a una disposición invertida ni durante el rebote.
replaceChildren() sustituye todos los nodos hijos directos, no el elemento mismo. Acepta cualquier número de objetos Node o cadenas, mueve los nodos existentes en vez de clonarlos y convierte las cadenas en nodos Text sin interpretar HTML. Sin argumentos, vacía el elemento. Devuelve undefined; una inserción que infrinja la jerarquía del árbol puede lanzar HierarchyRequestError (una DOMException).
Primero sustituye el contenido, luego mide la nueva disposición y establece la posición, porque el intervalo de desplazamiento puede cambiar. ECMAScript 2024 es la versión de referencia del lenguaje JavaScript, no una versión de estas API de la plataforma web. El estándar DOM define replaceChildren() y CSSOM View define scrollTop, scrollHeight y clientHeight. La compatibilidad depende de la versión del navegador; para medir hace falta un motor de disposición visual.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element scrolling and child replacement</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'width:200px;height:100px;padding:0;border:0;overflow-x:hidden;overflow-y:auto;scroll-behavior:auto';
box.textContent = 'Old content';
document.body.append(box);
try {
const row = document.createElement('div');
row.style.height = '160px';
box.replaceChildren(row);
const end = box.scrollHeight - box.clientHeight;
box.scrollTop = end;
const atBottom = Math.abs(end - box.scrollTop) <= 1;
console.log(`${box.scrollHeight} ${box.clientHeight} ${atBottom}`);
box.replaceChildren('<b>Done</b>');
console.log(`${box.textContent} | ${box.children.length}`);
box.replaceChildren();
console.log(box.childNodes.length);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Resultado
160 100 true <b>Done</b> | 0 0
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. Las alturas 160 y 100 dan un recorrido de 60 píxeles CSS. `true` indica que la posición está dentro de la tolerancia para el extremo inferior. Las etiquetas aparecen como texto literal y el último `0` indica que no quedan nodos hijos.
Lecciones relacionadas
- JavaScript · Lección 42 · Avanzado · Versión: 4