CKTIS / JavaScript
DOMRect.width — largeur du rectangle
DOMRect.width est une propriété d’instance modifiable qui décrit la largeur d’un rectangle. Elle contient un nombre à virgule flottante et accepte les valeurs négatives. Ne la confondez pas avec la propriété en lecture seule DOMRectReadOnly.width.
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
rect.width
rect.width = valueDOMRect.width décrit la largeur du rectangle représenté par un objet DOMRect. C’est une propriété d’instance : lisez-la avec rect.width et modifiez-la avec rect.width = value. Son type Web IDL est unrestricted double, représenté en JavaScript par number. La valeur n’a pas besoin d’être entière ni positive ; ce type accepte aussi NaN, Infinity et -Infinity.
Le constructeur new DOMRect(x, y, width, height) reçoit la largeur en troisième argument. Une largeur négative n’est pas automatiquement convertie en valeur positive. Si x et width sont finis et que width est négatif, left vaut x + width et right vaut x. Cette règle simplifiée ne s’applique pas toujours aux valeurs infinies : avec x = Infinity et width = -Infinity, x + width vaut NaN, si bien que le calcul du maximum pour right renvoie NaN et non x.
En arithmétique exacte, pour des valeurs finies de x et de width avec width négatif, right - left serait égal à la valeur absolue de width, mais les arrondis en virgule flottante en JavaScript peuvent modifier le résultat. Par exemple, avec x = 1e20 et width = -8, x + width est arrondi à x, si bien que right - left vaut 0 et non 8.
DOMRect hérite de DOMRectReadOnly, mais permet de modifier width. Ce que représente le rectangle dépend de l’API qui l’a renvoyé ; la propriété seule ne précise pas le type de zone mesurée.
Il s’agit d’une fonctionnalité de l’API Web décrite dans Geometry Interfaces Module Level 1, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique qu’elle est largement disponible dans les navigateurs depuis janvier 2020, y compris dans les Web Workers. L’exemple utilise des coordonnées explicites et ne dépend donc pas de la mise en page.
Exemples
const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);
rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);Résultat
30.5 -8 2 10
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.