CKTIS / JavaScript
DOMRectReadOnly.width — anchura de un rectángulo
La propiedad `width`, de solo lectura, devuelve la anchura almacenada del rectángulo como número, conservando su signo y su parte fraccionaria, si la tiene.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
rect.widthDOMRectReadOnly.width es una propiedad de instancia de solo lectura. Se lee como rect.width, sin paréntesis, y devuelve un valor de tipo number. La unidad depende de la API que proporciona el rectángulo. Por ejemplo, para un elemento HTML, entry.contentRect.width de un ResizeObserverEntry indica la anchura de la caja de contenido en píxeles CSS.
Si creas el rectángulo, el tercer argumento de DOMRectReadOnly define width. Una anchura negativa sigue siendo negativa: con coordenadas finitas y anchura negativa, left vale x + width y right vale x. Para obtener la extensión horizontal no negativa de un rectángulo de anchura finita, usa Math.abs(rect.width).
Asignar un valor a width no modifica una instancia de DOMRectReadOnly: en modo estricto se lanza un TypeError; fuera de ese modo, la asignación se ignora. Si necesitas otra anchura, crea un rectángulo nuevo o usa la propiedad modificable width de un DOMRect. DOMRectReadOnly es una API web, no forma parte de ECMAScript; comprueba si está disponible en tu entorno de ejecución.
Ejemplos
(() => {
"use strict";
// Local fallback for runtimes without the Web API. It models only these three properties.
function demoReadOnlyRect(x, width) {
return {
get width() { return width; },
get left() { return width < 0 ? x + width : x; },
get right() { return width < 0 ? x : x + width; },
};
}
const rect = typeof DOMRectReadOnly === "function"
? new DOMRectReadOnly(10, 0, -4.5, 3)
: demoReadOnlyRect(10, -4.5);
console.log(`width=${rect.width}, left=${rect.left}, right=${rect.right}`);
try {
rect.width = 8;
} catch (error) {
console.log(`TypeError=${error instanceof TypeError}, width=${rect.width}`);
}
})();Resultado
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Ejecuta el código en la consola de un navegador compatible con `DOMRectReadOnly` para usar la API nativa. Si `DOMRectReadOnly` no está disponible, como en Node.js, el ejemplo usa un modelo local que solo reproduce `width`, `left` y `right`. La anchura negativa sigue siendo `-4.5` y la asignación en modo estricto lanza un `TypeError` que el ejemplo captura.
Lecciones relacionadas
- JavaScript · Lección 32 · Intermedio · Versión: 3