Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Medir la altura del rectángulo delimitador de un elemento

`getBoundingClientRect()` mide la geometría de un elemento respecto al área de visualización. `DOMRect.height` indica la altura del rectángulo en píxeles CSS.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const rect = element.getBoundingClientRect();
const height = rect.height;

Llama a element.getBoundingClientRect() sin argumentos. Este método de instancia de Element devuelve un DOMRect a partir de la lista de getClientRects(). Si la lista está vacía, devuelve un rectángulo con x, y, width y height iguales a 0. Si cada rectángulo de la lista tiene anchura o altura cero, devuelve el primero, cuya altura puede ser distinta de cero. En caso contrario, devuelve el rectángulo más pequeño, alineado con los ejes, que encierra todos los rectángulos con anchura o altura distinta de cero, incluidos los que solo tienen una dimensión distinta de cero. Coordenadas como top y left son relativas al área de visualización y pueden cambiar al desplazarse por la página. La altura es una dimensión, no una coordenada.

Lee rect.height sin paréntesis. Es un número en píxeles CSS que puede tener parte fraccionaria. Para un elemento HTML sencillo con una sola caja, la medida incluye contenido, relleno (padding) y bordes, pero no márgenes. Tiene en cuenta las transformaciones CSS, así que puede diferir de height en CSS y de offsetHeight, la altura entera de la disposición. Si el elemento no genera ninguna caja CSS, como ocurre con display: none, la altura es 0.

El rectángulo es una instantánea. Vuelve a medir tras un cambio de disposición o de transformación. Asignar un valor a rect.height solo cambia el objeto DOMRect, no el elemento; en DOMRectReadOnly la propiedad es de solo lectura.

Es una API web, no una característica de ECMAScript 2024. La medición requiere un entorno con DOM y motor de disposición. Comprueba el resultado de querySelector() antes de llamar al método: intentarlo sobre null lanza un TypeError en lugar de devolver una medida de cero.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Bounding rectangle height</title>
</head>
<body>
  <script>
    const box = document.createElement('div');
    box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
    document.body.append(box);

    const before = box.getBoundingClientRect();
    box.style.transform = 'scaleY(0.5)';

    console.log(before.height);
    console.log(box.getBoundingClientRect().height);
    box.remove();
  </script>
</body>
</html>

Resultado

54
27

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de las herramientas de desarrollo. El rectángulo guardado indica `54`; tras `scaleY(0.5)`, la nueva medición indica `27`.

Lecciones relacionadas

  • JavaScript · Lección 11 · Avanzado · Versión: 4

Fuentes