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

CKTIS / JavaScript

DOMRect.height — hauteur du rectangle

DOMRect.height est la dimension verticale modifiable d’un rectangle. Elle peut être négative et influe sur les bords supérieur et inférieur calculés.

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.height
rect.height = value

DOMRect.height désigne une propriété d’instance qui se lit sous la forme rect.height. Elle stocke une dimension verticale de type unrestricted double et autorise donc les fractions, les valeurs négatives, NaN et les infinis. Dans new DOMRect(x, y, width, height), elle correspond au quatrième argument et vaut 0 par défaut.

Avec DOMRect, vous pouvez affecter une valeur à rect.height = value ; avec DOMRectReadOnly, la propriété est en lecture seule. L’affectation ne modifie pas y. Pour des valeurs finies, top est le minimum de y et y + height, tandis que bottom en est le maximum. Une valeur height négative place donc top au-dessus de y.

Il s’agit d’une API Web du Geometry Interfaces Module Level 1, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Vérifiez sa disponibilité dans le navigateur cible ; Node 24 dans le dépôt ne confirme pas sa prise en charge par les navigateurs.

Exemples

const rect = new DOMRect(10, 20, 30, 40);
console.log(rect.height);
rect.height = -8;
console.log(rect.height, rect.y, rect.top, rect.bottom);

Résultat

40
-8 20 12 20

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.

Sources