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

CKTIS / JavaScript

DOMRect.top — coordonnée du bord supérieur

`DOMRect.top` est une propriété en lecture seule qui renvoie la coordonnée du bord supérieur d’un rectangle. Même si la hauteur est négative, l’arrondi en virgule flottante peut donner un résultat égal à `y`.

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

DOMRect.top est une propriété d’instance héritée de DOMRectReadOnly. Elle renvoie un nombre qui indique la coordonnée du bord supérieur, et non la hauteur du rectangle.

Pour des valeurs finies de y et height, elle correspond à Math.min(rect.y, rect.y + rect.height). Lorsque la hauteur est positive ou nulle, elle est égale à y ; lorsqu’elle est négative, elle vaut y + height.

top reste en lecture seule même sur un DOMRect modifiable : modifiez y ou height, pas top. L’exemple montre que le résultat passe de 30 à 50. Il s’agit d’une API Web, et non d’une fonctionnalité du langage ECMAScript ; la présence de Node 24 ne garantit pas sa disponibilité.

Exemples

const rect = new DOMRect(10, 50, 80, -20);
console.log(rect.top);
rect.height = 20;
console.log(rect.top);

Résultat

30
50

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