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

CKTIS / JavaScript

DOMRect : les propriétés width et height

Lisez la largeur et la hauteur d’un rectangle, interprétez les valeurs fractionnaires ou négatives et distinguez les dimensions mesurées d’un élément de ses dimensions CSS.

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

Syntaxe

rect.width
rect.height
rect.width = newWidth
rect.height = newHeight

rect.width et rect.height sont des propriétés numériques d’instance : elles indiquent respectivement la largeur et la hauteur, et non des coordonnées de position. Lisez-les sans parenthèses. Elles sont modifiables sur DOMRect et en lecture seule sur DOMRectReadOnly.

Les dimensions peuvent être fractionnaires. Si vous construisez vous-même le rectangle, elles peuvent aussi être négatives. Si width est négatif, left vaut x + width ; sinon, il vaut x. Si height est négatif, top vaut y + height ; sinon, il vaut y. Le signe négatif change le sens à partir du point (x, y), pas la dimension en valeur absolue.

element.getBoundingClientRect() renvoie le rectangle qui englobe les boîtes de bordure non vides de l’élément, bordures et marges intérieures (padding) comprises, mais sans les marges extérieures. S’il existe des boîtes non vides, les boîtes vides sont ignorées. Si toutes les boîtes sont vides, la méthode renvoie un rectangle de largeur et de hauteur nulles à l’origine de la première boîte. Ses dimensions sont exprimées en pixels CSS et tiennent compte des transformations CSS. Elles ne correspondent donc pas forcément aux valeurs CSS width et height de l’élément. Modifier l’objet renvoyé ne modifie pas l’élément. Rappelez la méthode pour obtenir une nouvelle mesure.

DOMRect est une API Web, pas une fonctionnalité d’ECMAScript 2024. Sa disponibilité dépend de l’environnement d’exécution.

Exemples

{
  const x = 10, y = 20, width = -30.5, height = 12.25;
  // Without native DOMRect, model only the geometry used in this example.
  const rect = typeof globalThis.DOMRect === "function"
    ? new globalThis.DOMRect(x, y, width, height)
    : {
        x, y, width, height,
        get left() {
          return this.width < 0 ? this.x + this.width : this.x;
        },
      };
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
  rect.width = 30.5;
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}

Résultat

width=-30.5, height=12.25, left=-20.5
width=30.5, height=12.25, left=10

Exécutez le code dans la console d’un navigateur pour utiliser le `DOMRect` natif. Dans Node.js sans `DOMRect`, l’exemple utilise un modèle géométrique simplifié. Le changement de signe de `width` fait passer `left` de `-20.5` à `10` ; `height` ne change pas.

Leçons associées

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

Sources