CKTIS / JavaScript
DOMRect: propiedades width y height
Lee el ancho y el alto de un rectángulo, interpreta los valores fraccionarios y negativos y distingue las dimensiones medidas de un elemento de sus valores CSS.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width y rect.height son propiedades numéricas de instancia: indican el ancho y el alto, respectivamente, no coordenadas de posición. Léelas sin paréntesis. Se pueden modificar en DOMRect, pero son de solo lectura en DOMRectReadOnly.
Las dimensiones pueden ser fraccionarias. Si construyes el rectángulo, también pueden ser negativas. Si width es negativo, left vale x + width; si no, vale x. Si height es negativo, top vale y + height; si no, vale y. Un signo negativo cambia la dirección desde (x, y), no el tamaño absoluto.
element.getBoundingClientRect() devuelve el rectángulo que abarca las cajas de borde no vacías del elemento, incluidos el relleno (padding) y los bordes, pero no los márgenes. Si hay cajas no vacías, se ignoran las vacías. Si todas las cajas están vacías, el método devuelve un rectángulo de ancho y alto cero en el origen de la primera caja. Sus dimensiones se expresan en píxeles CSS y tienen en cuenta las transformaciones CSS, por lo que no tienen por qué coincidir con los valores CSS width y height del elemento. Modificar el objeto devuelto no cambia el elemento. Vuelve a llamar al método para obtener una nueva medición.
DOMRect es una API web, no forma parte de ECMAScript 2024. Su disponibilidad depende del entorno de ejecución.
Ejemplos
{
const x = 10, y = 20, width = -30.5, height = 12.25;
// Without native DOMRect, model only the geometry used in this example.
const rect = typeof globalThis.DOMRect === "function"
? new globalThis.DOMRect(x, y, width, height)
: {
x, y, width, height,
get left() {
return this.width < 0 ? this.x + this.width : this.x;
},
};
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
rect.width = 30.5;
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}Resultado
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Ejecuta el código en la consola de un navegador para usar `DOMRect` de forma nativa. En Node.js sin `DOMRect`, el ejemplo usa un modelo geométrico simplificado. Al cambiar el signo de `width`, `left` pasa de `-20.5` a `10`; `height` no cambia.
Lecciones relacionadas
- JavaScript · Lección 35 · Intermedio · Versión: 3