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

CKTIS / JavaScript

DOMRectReadOnly.width — largeur d’un rectangle

La propriété `width`, en lecture seule, renvoie la largeur stockée du rectangle sous forme de nombre, avec son signe et son éventuelle partie fractionnaire.

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

Syntaxe

rect.width

DOMRectReadOnly.width est une propriété d’instance en lecture seule. Lis-la avec rect.width, sans parenthèses. Le résultat est de type number. L’unité dépend de l’API qui fournit le rectangle. Par exemple, pour un élément HTML, entry.contentRect.width d’un objet ResizeObserverEntry donne la largeur de la boîte de contenu en pixels CSS.

Quand tu crées toi-même un rectangle, le troisième argument de DOMRectReadOnly définit width. Une largeur négative reste négative : avec des coordonnées finies et une largeur négative, left vaut x + width et right vaut x. Pour obtenir l’étendue horizontale non négative d’un rectangle de largeur finie, utilise Math.abs(rect.width).

Une affectation à width ne modifie pas une instance de DOMRectReadOnly : elle déclenche une exception TypeError en mode strict et est ignorée sinon. Pour obtenir une autre largeur, crée un nouveau rectangle ou utilise la propriété modifiable width d’un DOMRect. DOMRectReadOnly est une API Web, pas une fonctionnalité d’ECMAScript ; vérifie sa disponibilité dans ton environnement cible.

Exemples

(() => {
  "use strict";

  // Local fallback for runtimes without the Web API. It models only these three properties.
  function demoReadOnlyRect(x, width) {
    return {
      get width() { return width; },
      get left() { return width < 0 ? x + width : x; },
      get right() { return width < 0 ? x : x + width; },
    };
  }

  const rect = typeof DOMRectReadOnly === "function"
    ? new DOMRectReadOnly(10, 0, -4.5, 3)
    : demoReadOnlyRect(10, -4.5);
  console.log(`width=${rect.width}, left=${rect.left}, right=${rect.right}`);

  try {
    rect.width = 8;
  } catch (error) {
    console.log(`TypeError=${error instanceof TypeError}, width=${rect.width}`);
  }
})();

Résultat

width=-4.5, left=5.5, right=10
TypeError=true, width=-4.5

Exécute le code dans la console d’un navigateur qui prend en charge `DOMRectReadOnly` pour utiliser l’API native. Si `DOMRectReadOnly` n’est pas disponible, comme dans Node.js, l’exemple utilise un modèle local limité à `width`, `left` et `right`. La largeur négative reste à `-4.5` et l’affectation en mode strict déclenche une exception `TypeError` que l’exemple intercepte.

Leçons associées

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

Sources