CKTIS / JavaScript
Element.getBoundingClientRect(): el rectángulo delimitador de un elemento
Element.getBoundingClientRect() devuelve un DOMRect que describe la posición y el tamaño de un elemento respecto a la ventana gráfica. La medición incluye el padding, los bordes y las transformaciones CSS; el resultado es una instantánea.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const rect = element.getBoundingClientRect();Element.getBoundingClientRect es un método de la API Web que se llama sin argumentos como element.getBoundingClientRect(). Devuelve un DOMRect: x, y, width, height y los bordes top, right, bottom, left. Las coordenadas son relativas a la ventana gráfica y se expresan en píxeles CSS; pueden tener decimales.
En un elemento CSS normal, la medición incluye el padding y los bordes, pero no los márgenes. Tiene en cuenta las transformaciones del elemento y de sus antecesores. Una rotación produce un rectángulo delimitador alineado con los ejes, no la forma rotada en sí. getClientRects() devuelve los rectángulos de los distintos fragmentos. Si la lista no está vacía y cada rectángulo tiene ancho cero o alto cero, getBoundingClientRect() devuelve el primer rectángulo de la lista. En los demás casos en que la lista no está vacía, devuelve el rectángulo más pequeño que engloba todos los rectángulos de la lista salvo aquellos cuyo ancho y alto son ambos cero.
El resultado no se actualiza automáticamente: vuelve a medir después de cambios en el diseño o de desplazarte por la página. Si no hay una caja de diseño, por ejemplo con display: none, la posición y las dimensiones son cero. Esto describe geometría, no comprueba la visibilidad ni si algo lo tapa.
El ejemplo crea un elemento, lee sus medidas y lo elimina. width es 124 y height es 64, porque el padding y los bordes se suman a las dimensiones del contenido.
Ejemplos
(() => {
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
console.log(JSON.stringify({
x: rect.x,
y: rect.y,
width: rect.width,
height: rect.height
}));
} finally {
box.remove();
}
})();Resultado
{"x":20,"y":30,"width":124,"height":64}El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.