Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Element.getBoundingClientRect() : le rectangle englobant d’un élément

Element.getBoundingClientRect() renvoie un DOMRect qui décrit la position et la taille d’un élément par rapport à la fenêtre d’affichage. La mesure inclut le padding, les bordures et les transformations CSS ; le résultat est un instantané.

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

Syntaxe

const rect = element.getBoundingClientRect();

Element.getBoundingClientRect est une méthode de l’API Web appelée sans argument sous la forme element.getBoundingClientRect(). Elle renvoie un DOMRect : x, y, width, height, ainsi que les bords top, right, bottom, left. Les coordonnées sont relatives à la fenêtre d’affichage et exprimées en pixels CSS ; elles peuvent être fractionnaires.

Pour un élément CSS ordinaire, la mesure inclut le padding et les bordures, mais pas les marges. Elle tient compte des transformations appliquées à l’élément et à ses ancêtres. Une rotation produit un rectangle englobant aligné sur les axes, et non la forme tournée elle-même. getClientRects() renvoie les rectangles des différents fragments. Si la liste n’est pas vide et que chaque rectangle a une largeur nulle ou une hauteur nulle, getBoundingClientRect() renvoie le premier rectangle de la liste. Dans les autres cas où la liste n’est pas vide, la méthode renvoie le plus petit rectangle englobant tous les rectangles de la liste, à l’exception de ceux dont la largeur et la hauteur sont toutes deux nulles.

Le résultat ne se met pas à jour automatiquement : effectuez une nouvelle mesure après une modification de la mise en page ou un défilement. L’absence de boîte de mise en page, par exemple avec display: none, donne une position et des dimensions nulles. Il s’agit de géométrie, et non d’un test de visibilité ou de masquage.

L’exemple crée un élément, lit sa mesure puis le supprime. width vaut 124 et height vaut 64, car le padding et les bordures s’ajoutent aux dimensions du contenu.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources