KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.getBoundingClientRect(): de begrenzende rechthoek van een element

Element.getBoundingClientRect() retourneert een DOMRect met de positie en afmetingen van een element ten opzichte van het weergavevenster. De meting omvat padding, randen en CSS-transformaties; het resultaat is een momentopname.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const rect = element.getBoundingClientRect();

Element.getBoundingClientRect is een methode van de Web API die je zonder argumenten aanroept als element.getBoundingClientRect(). De methode retourneert een DOMRect: x, y, width, height en de randen top, right, bottom, left. De coördinaten zijn relatief aan het weergavevenster en worden uitgedrukt in CSS-pixels; ze kunnen decimalen bevatten.

Bij een gewoon CSS-element omvat de meting padding en randen, maar geen marges. Transformaties van het element en zijn voorouders worden meegenomen. Een rotatie levert een as-uitgelijnde begrenzende rechthoek op, niet de gedraaide vorm zelf. getClientRects() retourneert de rechthoeken van de afzonderlijke fragmenten. Als de lijst niet leeg is en elke rechthoek een breedte van nul of een hoogte van nul heeft, retourneert getBoundingClientRect() de eerste rechthoek uit de lijst. In alle overige gevallen met een niet-lege lijst retourneert de methode de kleinste rechthoek die alle rechthoeken in de lijst omsluit, behalve de rechthoeken waarvan zowel de breedte als de hoogte nul is.

Het resultaat wordt niet automatisch bijgewerkt: meet opnieuw na wijzigingen in de lay-out of na scrollen. Als er geen lay-outvak is, bijvoorbeeld bij display: none, zijn de positie en afmetingen nul. Dit is geometrie, geen test voor zichtbaarheid of bedekking.

Het voorbeeld maakt een element, leest de meting uit en verwijdert het element. width is 124 en height is 64, omdat padding en randen bij de inhoudsafmetingen worden opgeteld.

Voorbeelden

(() => {
  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();
  }
})();

Resultaat

{"x":20,"y":30,"width":124,"height":64}

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen