CKTIS / JavaScript
DOMRect: propriedades width e height
Lê a largura e a altura de um retângulo, interpreta valores fracionários e negativos e distingue as dimensões medidas de um elemento dos seus valores CSS.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width e rect.height são propriedades numéricas de instância: indicam, respetivamente, a largura e a altura, e não coordenadas de posição. Lê-as sem parênteses. São modificáveis em DOMRect e só de leitura em DOMRectReadOnly.
As dimensões podem ser fracionárias. Num retângulo que cries, também podem ser negativas. Se width for negativo, left vale x + width; caso contrário, vale x. Se height for negativo, top vale y + height; caso contrário, vale y. Um sinal negativo altera o sentido a partir de (x, y), não a dimensão em valor absoluto.
element.getBoundingClientRect() devolve o retângulo que envolve as caixas de contorno não vazias do elemento, incluindo o espaçamento interior (padding) e os contornos, mas não as margens. Se houver caixas não vazias, as vazias são ignoradas. Se todas as caixas estiverem vazias, o método devolve um retângulo com largura e altura iguais a zero na origem da primeira caixa. As dimensões são dadas em píxeis CSS e têm em conta as transformações CSS, pelo que podem não coincidir com os valores CSS width e height do elemento. Alterar o objeto devolvido não altera o elemento. Volta a chamar o método para obter uma nova medição.
DOMRect é uma API Web, não faz parte do ECMAScript 2024. A disponibilidade depende do ambiente de execução.
Exemplos
{
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
Executa o código na consola de um navegador para usares o `DOMRect` nativo. Em Node.js sem `DOMRect`, o exemplo usa um modelo geométrico simplificado. Ao mudar o sinal de `width`, `left` passa de `-20.5` para `10`; `height` mantém-se.
Lições relacionadas
- JavaScript · Lição 35 · Intermédio · Versão: 3