CKTIS / JavaScript
DOMRect: borde superior (`top`) y altura (`height`)
`top` indica dónde está el borde superior del rectángulo y `height` da su altura con signo. Son dos datos distintos, tanto al crear un rectángulo como al medir un elemento.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top y rect.height son propiedades de instancia, no métodos. top es la coordenada vertical del borde superior. height es la altura con signo, no una coordenada. Ambos valores son números y pueden tener parte fraccionaria.
Para valores finitos de y y height, top vale y + height si height < 0, y y en caso contrario. Una altura negativa en un rectángulo creado manualmente sigue siendo negativa: no se convierte en su valor absoluto. En un DOMRect puedes asignar un valor a height; al leer top se tiene en cuenta ese cambio. top es de solo lectura en ambas interfaces, y height también lo es en DOMRectReadOnly.
En el resultado de element.getBoundingClientRect(), ambos valores se expresan en píxeles CSS. top se mide respecto al borde superior del área de visualización y puede ser negativo si el borde superior del rectángulo queda por encima. height es la altura no negativa del rectángulo delimitador, que incluye el relleno (padding) y los bordes, no solo el contenido. El resultado no se actualiza automáticamente: vuelve a llamar al método después de un desplazamiento o de un cambio de diseño para obtener una medición nueva. Modificar el rectángulo devuelto no cambia el elemento.
DOMRect forma parte de las API web, no de ECMAScript 2024. No des por hecho que está disponible en todos los entornos de ejecución de JavaScript.
Ejemplos
{
const y = 20;
const height = 8;
// Without DOMRect, model only top and signed height for finite values.
const rect = typeof DOMRect === "function"
? new DOMRect(0, y, 10, height)
: {
y,
height,
get top() {
return this.height < 0 ? this.y + this.height : this.y;
},
};
console.log(`top=${rect.top}, height=${rect.height}`);
rect.height = -8;
console.log(`top=${rect.top}, height=${rect.height}`);
}Resultado
top=20, height=8 top=12, height=-8
El ejemplo no necesita ningún elemento de la página. `y` sigue valiendo `20`, pero tras asignar `height = -8`, el borde superior queda en `12`.
Lecciones relacionadas
- JavaScript · Lección 34 · Intermedio · Versión: 3