CKTIS / JavaScript
Altura y posición de desplazamiento: offsetHeight, clientHeight y scrollTop
Distingue la altura de la caja exterior, la altura del área interior y la posición actual del desplazamiento vertical de un elemento. Aprende a detectar el final sin exigir una igualdad numérica exacta.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
element.offsetHeight // HTMLElement, read-only
element.clientHeight // Element, read-only
element.scrollTop // Element, read
element.scrollTop = y // Element, write a vertical offset in CSS pixelsEstas propiedades son del DOM del navegador, no de ECMAScript. offsetHeight pertenece a HTMLElement; clientHeight y scrollTop pertenecen a Element y las heredan los elementos HTML. Accede a ellas en una instancia de elemento, por ejemplo con el.clientHeight. Todas las medidas se expresan en píxeles CSS.
offsetHeight es la altura entera de la caja en la disposición de la página y es de solo lectura. Normalmente incluye el relleno (padding), los bordes y la barra de desplazamiento horizontal si se muestra, pero no los márgenes. No tiene en cuenta las transformaciones CSS; usa el.getBoundingClientRect().height para obtener la altura del rectángulo delimitador tras la transformación.
clientHeight es la altura interior entera y es de solo lectura. Incluye el relleno, pero excluye los bordes, los márgenes y la barra de desplazamiento horizontal. Ambas alturas valen 0 si display: none en el elemento o en un antepasado lo deja sin caja de disposición. En el elemento raíz del documento (body en modo quirks), clientHeight mide la altura del área de visualización sin la barra de desplazamiento horizontal.
scrollTop lee o establece el desplazamiento vertical respecto a su origen. Normalmente vale 0 arriba, pero puede ser fraccionario o negativo, por ejemplo con flex-direction: column-reverse. En Safari, el rebote al sobrepasar un extremo puede dar temporalmente valores fuera del intervalo normal. La asignación el.scrollTop = y permite desplazar contenido con overflow: hidden, pero no con overflow: clip.
scrollHeight es la altura entera de todo el contenido, incluido el desbordamiento fuera de la vista, más el relleno. En un contenedor que se desplaza normalmente hacia abajo, sin sobrepasar los extremos, detecta el final con Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Usa una tolerancia de un píxel CSS en lugar de ===, porque scrollTop puede ser fraccionario. No apliques esta comprobación sin cambios a disposiciones con dirección invertida.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element height and scroll position</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'position:fixed;top:0;left:0;width:160px;height:100px;' +
'box-sizing:content-box;padding:0;border:4px solid;overflow:hidden;' +
'scroll-behavior:auto;writing-mode:horizontal-tb;';
const content = document.createElement('div');
content.style.height = '300px';
box.append(content);
document.body.append(box);
try {
box.scrollTop = 40;
console.log(`offsetHeight=${box.offsetHeight} clientHeight=${box.clientHeight} scrollHeight=${box.scrollHeight} scrollTop=${box.scrollTop}`);
box.scrollTop = 1000;
const atBottom = Math.abs(box.scrollHeight - box.clientHeight - box.scrollTop) <= 1;
console.log(`scrollTop=${box.scrollTop} atBottom=${atBottom}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Resultado
offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40 scrollTop=200 atBottom=true
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba el resultado en la consola de desarrollo. Los bordes añaden 8 px a `offsetHeight`, pero no a `clientHeight`. El intento de desplazar hasta 1000 se detiene en 200, el límite inferior.
Lecciones relacionadas
- JavaScript · Lección 11 · Avanzado · Versión: 4