CKTIS / JavaScript
Element.getBoundingClientRect(): o retângulo delimitador de um elemento
Element.getBoundingClientRect() devolve um DOMRect que descreve a posição e o tamanho de um elemento relativamente à janela de visualização. A medição inclui padding, contornos e transformações CSS; o resultado é uma captura instantânea.
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
const rect = element.getBoundingClientRect();Element.getBoundingClientRect é um método da Web API chamado sem argumentos como element.getBoundingClientRect(). Devolve um DOMRect: x, y, width, height e as extremidades top, right, bottom, left. As coordenadas são relativas à janela de visualização e expressas em píxeis CSS; podem ser fracionárias.
Num elemento CSS normal, a medição inclui padding e contornos, mas não margens. Tem em conta as transformações do elemento e dos seus antecessores. Uma rotação produz um retângulo delimitador alinhado com os eixos, não a própria forma rodada. getClientRects() devolve os retângulos dos fragmentos individuais. Se a lista não estiver vazia e cada retângulo tiver largura zero ou altura zero, getBoundingClientRect() devolve o primeiro retângulo da lista. Nos restantes casos em que a lista não está vazia, devolve o menor retângulo que engloba todos os retângulos da lista, exceto aqueles em que tanto a largura como a altura são zero.
O resultado não é atualizado automaticamente: volta a medir depois de alterações ao esquema da página ou de deslocares a página. Se não existir uma caixa de esquema, por exemplo com display: none, a posição e as dimensões são zero. Isto representa geometria, não um teste de visibilidade ou de obstrução.
O exemplo cria um elemento, lê a medição e remove-o. width é 124 e height é 64, porque o padding e os contornos são adicionados às dimensões do conteúdo.
Exemplos
(() => {
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
console.log(JSON.stringify({
x: rect.x,
y: rect.y,
width: rect.width,
height: rect.height
}));
} finally {
box.remove();
}
})();Resultado
{"x":20,"y":30,"width":124,"height":64}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.