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.widthDOMRectReadOnly.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