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

CKTIS / JavaScript

Mesurer la hauteur du rectangle englobant d’un élément

`getBoundingClientRect()` mesure la géométrie d’un élément par rapport à la zone d’affichage. `DOMRect.height` donne la hauteur du rectangle en pixels CSS.

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

Syntaxe

const rect = element.getBoundingClientRect();
const height = rect.height;

Appelez element.getBoundingClientRect() sans argument. Cette méthode d’instance de Element renvoie un DOMRect à partir de la liste fournie par getClientRects(). Si la liste est vide, elle renvoie un rectangle dont les propriétés x, y, width et height valent toutes 0. Si chaque rectangle de la liste a une largeur ou une hauteur nulle, elle renvoie le premier rectangle, dont la hauteur peut être non nulle. Sinon, elle renvoie le plus petit rectangle aligné sur les axes qui englobe tous les rectangles de largeur ou de hauteur non nulle, y compris ceux dont une seule dimension est non nulle. Les coordonnées telles que top et left sont relatives à la zone d’affichage et peuvent changer lors du défilement. La hauteur est une dimension, pas une coordonnée.

Lisez rect.height sans parenthèses. C’est un nombre exprimé en pixels CSS, éventuellement fractionnaire. Pour un élément HTML simple à une seule boîte, la mesure inclut le contenu, les marges intérieures (padding) et les bordures, mais pas les marges extérieures. Elle tient compte des transformations CSS et peut donc différer de la propriété CSS height et de la hauteur entière de mise en page offsetHeight. Si l’élément ne génère aucune boîte CSS, comme avec display: none, la hauteur vaut 0.

Le rectangle représente l’état au moment de l’appel. Refaites la mesure après un changement de mise en page ou de transformation. Affecter une valeur à rect.height modifie uniquement l’objet DOMRect, pas l’élément ; sur DOMRectReadOnly, la propriété est en lecture seule.

Il s’agit d’une API web, pas d’une fonctionnalité d’ECMAScript 2024. La mesure nécessite un environnement doté d’un DOM et d’un moteur de mise en page. Vérifiez le résultat de querySelector() avant l’appel : tenter l’appel sur null lève une TypeError au lieu de donner une hauteur nulle.

Exemples

<!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>

Résultat

54
27

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console des outils de développement. Le rectangle mémorisé donne `54` ; après `scaleY(0.5)`, la nouvelle mesure donne `27`.

Leçons associées

  • JavaScript · Leçon 11 · Avancé · Version : 4

Sources