CKTIS / JavaScript
De hoogte van de begrenzingsrechthoek van een element meten
`getBoundingClientRect()` meet de geometrie van een element ten opzichte van de viewport. `DOMRect.height` geeft de hoogte van de rechthoek in CSS-pixels.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const rect = element.getBoundingClientRect();
const height = rect.height;Roep element.getBoundingClientRect() aan zonder argumenten. Deze instantiemethode van Element geeft een DOMRect terug op basis van de lijst van getClientRects(). Is de lijst leeg, dan geeft de methode een rechthoek terug waarvan x, y, width en height allemaal 0 zijn. Heeft elke rechthoek in de lijst een breedte of hoogte van nul, dan geeft de methode de eerste rechthoek terug. Die kan nog steeds een hoogte hebben die niet nul is. Anders geeft de methode de kleinste rechthoek met zijden parallel aan de assen terug die alle rechthoeken omsluit waarvan de breedte of hoogte niet nul is, ook als slechts één afmeting niet nul is. Coördinaten zoals top en left zijn relatief aan de viewport en kunnen veranderen bij het scrollen. Hoogte is een afmeting, geen coördinaat.
Lees rect.height uit zonder haakjes. Dit is een getal in CSS-pixels en kan een fractie bevatten. Bij een eenvoudig HTML-element met één vak omvat de meting de inhoud, binnenruimte (padding) en randen, maar geen marges. De meting houdt rekening met CSS-transformaties en kan dus afwijken van de CSS-eigenschap height en van offsetHeight, de gehele layouthoogte. Genereert het element geen CSS-vak, bijvoorbeeld bij display: none, dan is de hoogte 0.
De rechthoek is een momentopname. Meet opnieuw na een wijziging in de layout of transformatie. Een toewijzing aan rect.height wijzigt alleen het DOMRect-object, niet het element; in DOMRectReadOnly is de eigenschap alleen-lezen.
Dit is een web-API, geen onderdeel van ECMAScript 2024. De meting vereist een omgeving met DOM- en layoutondersteuning. Controleer het resultaat van querySelector() vóór de aanroep: een poging om de methode op null aan te roepen levert een TypeError op, geen nulmeting.
Voorbeelden
<!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>Resultaat
54 27
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de console van de ontwikkelaarstools. De opgeslagen rechthoek geeft `54`; na `scaleY(0.5)` geeft een nieuwe meting `27`.
Gerelateerde lessen
- JavaScript · Les 11 · Gevorderd · Versie: 4