KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.getBoundingClientRect(): afmetingen en positie van een DOMRect

Meet de begrenzende rechthoek van een element in CSS-pixels en onderscheid coördinaten ten opzichte van de viewport van documentcoördinaten.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;

element.getBoundingClientRect() verwacht geen argumenten en geeft een DOMRect terug. Dit is een web-API en geen onderdeel van ECMAScript. Voor de meting is een omgeving nodig die de lay-out van de DOM berekent; de beschikbaarheid hangt af van de uitvoeromgeving.

Bij een HTML-element is de meting gebaseerd op rechthoeken die overeenkomen met de CSS-boxen tot aan de buitenkant van hun randen, met zijden evenwijdig aan de assen. De meting omvat padding en randen, houdt rekening met CSS-transformaties en laat marges buiten beschouwing. Gebruik getClientRects() voor de afzonderlijke rechthoeken. Als de lijst leeg is, bijvoorbeeld bij display: none, zijn alle waarden nul. Heeft elke rechthoek een breedte of hoogte van nul, dan geeft de methode de eerste rechthoek in de lijst terug. Anders geeft ze de kleinste rechthoek terug die alle rechthoeken in de lijst omsluit, behalve die waarvan beide afmetingen nul zijn. Bij een inline-element over meerdere regels kan het resultaat ook ruimte tussen fragmenten omvatten. De rechthoek op zich bewijst niet dat het element zichtbaar is.

width en height zijn de afmetingen van de rechthoek. In dit resultaat zijn x en y gelijk aan left en top; right is left + width en bottom is top + height. Coördinaten worden gemeten vanaf de linkerbovenhoek van de viewport, niet vanaf de dichtstbijzijnde rand, en kunnen negatief zijn. Alle waarden zijn in CSS-pixels en kunnen een fractie bevatten.

Op een DOMRect kun je x, y, width en height wijzigen; de randcoördinaten worden afgeleid en zijn alleen-lezen. Bij een handmatig gemaakte rechthoek met negatieve width of height kan x afwijken van left of y van top. Het resultaat wijzigen verandert het element niet. Het resultaat is een momentopname: meet opnieuw na een lay-outwijziging of na scrollen als je actuele waarden nodig hebt.

Gebruik voor de linkerbovenhoek in documentcoördinaten rect.left + window.scrollX en rect.top + window.scrollY en lees de scrollwaarden af tijdens de meting. Daarmee verander je de oorsprong van de coördinaten; scrollen binnen een geneste container maak je er niet mee ongedaan.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Measuring an element</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  box.style.cssText = 'position: fixed; left: 24.5px; top: 16px; margin: 0; box-sizing: content-box; width: 104px; height: 44px; padding: 8px; border: 0;';
  document.body.append(box);
  try {
    const rect = box.getBoundingClientRect();
    const { x, y, width, height, top, right, bottom, left } = rect;
    console.log(`x=${x}, y=${y}, width=${width}, height=${height}, top=${top}, right=${right}, bottom=${bottom}, left=${left}`);

    box.style.left = '44.5px';
    console.log(`previous x=${rect.x}, current x=${box.getBoundingClientRect().x}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Resultaat

x=24.5, y=16, width=120, height=60, top=16, right=144.5, bottom=76, left=24.5
previous x=24.5, current x=44.5

Sla het voorbeeld op als HTML-bestand, open het in een browser en lees de uitvoer in de ontwikkelaarsconsole. De afmetingen omvatten padding aan weerszijden van elke as; het element heeft geen rand. Na het verplaatsen behoudt de oude rechthoek zijn oorspronkelijke `x`; alleen een nieuwe meting geeft de nieuwe `x`.

Gerelateerde lessen

  • JavaScript · Les 12 · Gevorderd · Versie: 4

Bronnen