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

CKTIS / JavaScript

DOMRect : bord supérieur (`top`) et hauteur (`height`)

`top` indique où se trouve le bord supérieur du rectangle, tandis que `height` donne sa hauteur signée. Ces propriétés répondent à deux questions différentes, que l’on crée un rectangle ou que l’on mesure un élément.

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

Syntaxe

rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()

rect.top et rect.height sont des propriétés d’instance, pas des méthodes. top est la coordonnée verticale du bord supérieur. height représente la hauteur signée, pas une coordonnée. Ces deux nombres peuvent avoir une partie fractionnaire.

Pour des valeurs finies de y et de height, top vaut y + height si height < 0, et y sinon. Une hauteur négative dans un rectangle construit manuellement reste négative : elle n’est pas convertie en valeur absolue. Dans un DOMRect, on peut modifier height et la lecture de top tient compte de ce changement. top est en lecture seule dans les deux interfaces ; height l’est aussi dans DOMRectReadOnly.

Dans le résultat de element.getBoundingClientRect(), les deux valeurs sont exprimées en pixels CSS. top est mesurée par rapport au haut de la zone d’affichage et peut être négative si le bord supérieur du rectangle se trouve au-dessus. height est la hauteur non négative du rectangle englobant, qui tient compte de l’espacement intérieur (padding) et des bordures, et pas seulement du contenu. Le résultat ne se met pas à jour automatiquement : rappelez la méthode après un défilement ou un changement de mise en page pour obtenir une nouvelle mesure. Modifier le rectangle renvoyé ne modifie pas l’élément.

DOMRect fait partie des API Web, pas d’ECMAScript 2024. Ne supposez pas que cette interface est disponible dans tous les environnements d’exécution JavaScript.

Exemples

{
  const y = 20;
  const height = 8;

  // Without DOMRect, model only top and signed height for finite values.
  const rect = typeof DOMRect === "function"
    ? new DOMRect(0, y, 10, height)
    : {
        y,
        height,
        get top() {
          return this.height < 0 ? this.y + this.height : this.y;
        },
      };

  console.log(`top=${rect.top}, height=${rect.height}`);

  rect.height = -8;
  console.log(`top=${rect.top}, height=${rect.height}`);
}

Résultat

top=20, height=8
top=12, height=-8

L’exemple ne nécessite aucun élément de la page. `y` reste à `20`, mais après l’affectation `height = -8`, le bord supérieur se trouve à `12`.

Leçons associées

  • JavaScript · Leçon 34 · Intermédiaire · Version : 3

Sources