CKTIS / JavaScript
Medir a altura do retângulo delimitador de um elemento
`getBoundingClientRect()` mede a geometria de um elemento em relação à área de visualização. `DOMRect.height` indica a altura do retângulo em píxeis CSS.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const rect = element.getBoundingClientRect();
const height = rect.height;Chama element.getBoundingClientRect() sem argumentos. Este método de instância de Element devolve um DOMRect com base na lista de getClientRects(). Se a lista estiver vazia, devolve um retângulo com x, y, width e height iguais a 0. Se cada retângulo da lista tiver largura ou altura igual a zero, devolve o primeiro retângulo, cuja altura pode ser diferente de zero. Caso contrário, devolve o menor retângulo alinhado com os eixos que contém todos os retângulos com largura ou altura diferente de zero, incluindo os que têm apenas uma dimensão diferente de zero. Coordenadas como top e left são relativas à área de visualização e podem mudar com o deslocamento da página. A altura é uma dimensão, não uma coordenada.
Lê rect.height sem parênteses. É um número em píxeis CSS e pode ter uma parte fracionária. Num elemento HTML simples com uma só caixa, a medida inclui o conteúdo, o espaçamento interior (padding) e os contornos, mas não as margens. Tem em conta as transformações CSS, pelo que pode diferir da propriedade CSS height e da altura inteira de disposição offsetHeight. Se o elemento não gerar nenhuma caixa CSS, como acontece com display: none, a altura é 0.
O retângulo representa o estado no momento da chamada. Volta a medir depois de uma mudança na disposição ou na transformação. Atribuir um valor a rect.height altera apenas o objeto DOMRect, não o elemento; em DOMRectReadOnly, a propriedade é só de leitura.
É uma API web, não uma funcionalidade de ECMAScript 2024. A medição exige um ambiente com DOM e suporte de disposição. Verifica o resultado de querySelector() antes da chamada: tentar chamar o método sobre null lança um TypeError, em vez de devolver uma medida igual a zero.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Bounding rectangle height</title>
</head>
<body>
<script>
const box = document.createElement('div');
box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
document.body.append(box);
const before = box.getBoundingClientRect();
box.style.transform = 'scaleY(0.5)';
console.log(before.height);
console.log(box.getBoundingClientRect().height);
box.remove();
</script>
</body>
</html>Resultado
54 27
Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola das ferramentas de desenvolvimento. O retângulo guardado indica `54`; depois de `scaleY(0.5)`, a nova medição indica `27`.
Lições relacionadas
- JavaScript · Lição 11 · Avançado · Versão: 4