HOWTO · JavaScript

Obtener la altura del elemento div en JavaScript

Este tutorial presenta cómo obtener la altura de un elemento div dentro de JavaScript.

En esta página

Para obtener la altura de un elemento <div> con JavaScript en el navegador, selecciónalo y consulta la medida que necesites: clientHeight para la caja interior, offsetHeight para la caja con bordes, scrollHeight para el contenido, incluido el que desborda el área visible, o getBoundingClientRect().height para la altura de su rectángulo renderizado. Cada propiedad mide partes distintas del elemento, por lo que sus valores pueden variar.

El ejemplo ejecutable de abajo modela una caja de contenido de 50px, con 4px de relleno y un borde de 1px. Se ejecuta en Node sin un DOM de navegador e imprime las medidas correspondientes. Las etiquetas que muestra la salida permanecen en inglés porque el bloque de ejemplo se conserva sin cambios. En un navegador, consulta esas mismas propiedades en el elemento DOM seleccionado.

const element = {
  contentHeight: 50,
  padding: 4,
  border: 1,
  get clientHeight() {
    return this.contentHeight + 2 * this.padding;
  },
  get offsetHeight() {
    return this.clientHeight + 2 * this.border;
  },
  get scrollHeight() {
    return this.clientHeight;
  },
  getBoundingClientRect() {
    return { height: this.offsetHeight };
  }
};

console.log('clientHeight:', element.clientHeight);
console.log('offsetHeight:', element.offsetHeight);
console.log('scrollHeight:', element.scrollHeight);
console.log('bounding height:', element.getBoundingClientRect().height);
clientHeight: 58
offsetHeight: 60
scrollHeight: 58
bounding height: 60

get div element height in JavaScript

Medir la altura de un div con JavaScript

Usa el DOM para seleccionar un elemento existente por su ID y luego elige una de las medidas siguientes. El ejemplo de Node anterior modela las lecturas para la caja indicada; para medir tu página, sustituye element por el resultado de document.getElementById('container') o por el de otro selector. Consulta sus dimensiones cuando el elemento ya esté en el documento y su diseño esté disponible.

Elige la medida según la caja que necesites: usa clientHeight para la caja interior, offsetHeight si quieres incluir los bordes, scrollHeight para obtener la altura total del contenido desplazable y getBoundingClientRect().height cuando te interese el rectángulo renderizado. Ninguna incluye los márgenes; si el espacio entre elementos forma parte de tu cálculo, mídelo aparte. Estos valores se expresan en píxeles CSS, no en píxeles físicos de pantalla.

clientHeight

clientHeight es la altura interior en píxeles CSS: incluye el relleno superior e inferior, pero excluye los bordes y los márgenes. En el ejemplo, con 50px de contenido y 4px de relleno en cada lado, el valor es 58. Esta propiedad devuelve un entero.

offsetHeight

offsetHeight incluye el contenido, el relleno, los bordes y cualquier barra de desplazamiento horizontal del elemento. Excluye los márgenes. En el ejemplo, el cálculo es 50 + 8 + 2 = 60 píxeles. Esta propiedad también devuelve un entero.

scrollHeight

scrollHeight mide la altura total del contenido, incluida la parte que queda fuera del área visible cuando hay desbordamiento. Incluye el relleno, pero excluye los bordes y los márgenes. En el ejemplo vale 58 porque el contenido no desborda; en una página con contenido desbordado, puede ser mayor que clientHeight. Es una medida entera y no se debe suponer que siempre coincide con clientHeight en todos los diseños.

getBoundingClientRect()

getBoundingClientRect() devuelve un rectángulo que describe el tamaño renderizado y la posición del elemento respecto de la ventana gráfica. Consulta su propiedad height para obtener la altura renderizada. Incluye el relleno y los bordes, por lo que en el ejemplo mide 60 píxeles. A diferencia de las propiedades de dimensión entera anteriores, esta altura puede tener decimales, por ejemplo, cuando el diseño o las transformaciones generan dimensiones subpíxel. Usa este método cuando necesites el rectángulo renderizado y no la altura del contenido desplazable.