Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

DOMRect.width — largura do retângulo

DOMRect.width é uma propriedade de instância gravável que descreve a largura de um retângulo. Contém um número de vírgula flutuante e permite valores negativos. Não a confundas com a propriedade só de leitura DOMRectReadOnly.width.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

rect.width
rect.width = value

DOMRect.width descreve a largura do retângulo representado por um objeto DOMRect. É uma propriedade de instância: lê-a como rect.width e altera-a com rect.width = value. O seu tipo Web IDL é unrestricted double, representado em JavaScript como number. O valor não tem de ser inteiro nem positivo; este tipo também admite NaN, Infinity e -Infinity.

O construtor new DOMRect(x, y, width, height) recebe a largura como terceiro argumento. Uma largura negativa não é convertida automaticamente num valor positivo. Se x e width forem finitos e width for negativo, left é x + width e right é x. Esta regra simplificada nem sempre se aplica a valores infinitos: com x = Infinity e width = -Infinity, x + width dá NaN, pelo que o cálculo do máximo para right devolve NaN, e não x.

Em aritmética exata, para valores finitos de x e width e com width negativo, right - left seria igual ao valor absoluto de width, mas o arredondamento em vírgula flutuante no JavaScript pode alterar o resultado. Por exemplo, com x = 1e20 e width = -8, x + width é arredondado para x, pelo que right - left dá 0, e não 8.

DOMRect herda de DOMRectReadOnly, mas permite escrever em width. O que o retângulo representa depende da API que o devolveu; a propriedade, por si só, não especifica o tipo de área medida.

Esta é uma funcionalidade da Web API descrita em Geometry Interfaces Module Level 1, não uma funcionalidade de uma edição específica de ECMAScript. A MDN assinala-a como amplamente disponível nos navegadores desde janeiro de 2020, incluindo em Web Workers. O exemplo usa coordenadas explícitas, pelo que não depende da disposição dos elementos na página.

Exemplos

const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);

rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);

Resultado

30.5
-8
2 10

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes