CKTIS / JavaScript
Rectángulo delimitador y desplazamientos del área cliente
Mide la posición y el tamaño de un elemento respecto a la ventana gráfica y distingue esos valores de los desplazamientos izquierdo y superior de su área cliente.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
element.getBoundingClientRect() // DOMRect
element.clientLeft // integer Number
element.clientTop // integer Numberelement.getBoundingClientRect() es un método de Element que no recibe argumentos. Devuelve un DOMRect calculado a partir de los rectángulos que getClientRects() da para las cajas de borde tras aplicar las transformaciones. Si la lista está vacía, todos los valores son cero. Si cada rectángulo de la lista tiene anchura o altura cero, el método devuelve el primer rectángulo de la lista. En caso contrario, devuelve el rectángulo más pequeño alineado con los ejes que engloba los rectángulos con anchura o altura distinta de cero. Incluye el relleno y los bordes, pero no los márgenes. left y top son coordenadas relativas a la esquina superior izquierda de la ventana gráfica; width y height son dimensiones. Los valores se expresan en píxeles CSS y pueden ser fraccionarios.
element.clientLeft y element.clientTop son propiedades de solo lectura, no métodos. Devuelven desplazamientos enteros en píxeles CSS sin tener en cuenta las transformaciones: el grosor del borde izquierdo y superior, respectivamente, más el espacio que ocupe una barra de desplazamiento en ese mismo lado. La barra vertical puede quedar a la izquierda, por ejemplo en un diseño de derecha a izquierda. No se incluye ni el relleno ni el margen. Ambas propiedades devuelven cero para una caja en línea o si no hay caja CSS.
El DOMRect es una instantánea. Si necesitas coordenadas actualizadas, vuelve a medir después de desplazar la página o cambiar su diseño. Para obtener coordenadas relativas al documento, suma window.scrollX a left y window.scrollY a top. No uses clientLeft y clientTop como coordenadas de la ventana gráfica ni como una conversión general de coordenadas tras una transformación. Estas API son de la plataforma web (CSSOM View), no de ECMAScript 2024; su disponibilidad depende del entorno de ejecución.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element geometry</title>
</head>
<body>
<script>
(() => {
// Use a 1:1 ratio so the borders need no device-pixel rounding.
if (window.devicePixelRatio !== 1) {
throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
}
const box = document.createElement('div');
box.style.cssText = `
position: fixed; left: 20px; top: 30px;
box-sizing: border-box; width: 80px; height: 40px;
border: solid black; border-width: 5px 2px 2px 3px;
overflow: hidden; transform-origin: top left; transform: scale(2);
`;
document.body.append(box);
try {
const { left, top, width, height } = box.getBoundingClientRect();
console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Resultado
rect: 20, 30, 160, 80 client: 3, 5
Abre el documento HTML en un navegador con el zoom de página al 100 % y un `devicePixelRatio` de `1`. Consulta el resultado en la consola del navegador. La escala duplica las dimensiones del rectángulo sin mover su esquina superior izquierda; los desplazamientos siguen siendo `3` y `5`.
Lecciones relacionadas
- JavaScript · Lección 35 · Avanzado · Versión: 4