CKTIS / JavaScript
DOMRectReadOnly.width — largura de um retângulo
A propriedade `width`, só de leitura, devolve a largura guardada do retângulo como um número, mantendo o sinal e a eventual parte fracionária.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
rect.widthDOMRectReadOnly.width é uma propriedade de instância só de leitura. Lê-a com rect.width, sem parênteses. O resultado é do tipo number. A unidade depende da API que fornece o retângulo. Por exemplo, para um elemento HTML, entry.contentRect.width de um objeto ResizeObserverEntry indica a largura da caixa de conteúdo em píxeis CSS.
Ao criares um retângulo, o terceiro argumento de DOMRectReadOnly define width. Uma largura negativa mantém-se negativa: com coordenadas finitas e largura negativa, left é igual a x + width e right é igual a x. Para obteres a extensão horizontal não negativa de um retângulo com largura finita, usa Math.abs(rect.width).
Atribuir um valor a width não altera uma instância de DOMRectReadOnly: em modo estrito, a atribuição lança um TypeError; fora desse modo, é ignorada. Se precisares de outra largura, cria um novo retângulo ou usa a propriedade gravável width de um DOMRect. DOMRectReadOnly é uma API da Web e não faz parte de ECMAScript; verifica se está disponível no ambiente de execução de destino.
Exemplos
(() => {
"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
Executa o código na consola de um navegador que suporte `DOMRectReadOnly` para usares a API nativa. Se `DOMRectReadOnly` não estiver disponível, como no Node.js, o exemplo usa um modelo local que reproduz apenas `width`, `left` e `right`. A largura negativa mantém-se em `-4.5` e a atribuição em modo estrito lança um `TypeError` que o exemplo interceta.
Lições relacionadas
- JavaScript · Lição 32 · Intermédio · Versão: 3