blob: 103be19e9369bece2bfe3832d5de0c23ecb5647a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
---
title: DOMRect
slug: Web/API/DOMRect
tags:
- API
- DOM
- Géométrie
- Objets
- Rectangle
translation_of: Web/API/DOMRect
---
{{draft}}{{APIRef("Geometry Interfaces")}}{{ SeeCompatTable() }}
Un **`DOMRect`** représente un rectangle.
Le type de boîte représenté par le `DOMRect` est spécifié par la méthode ou la propriété qui l'a retourné. Par exemple, {{domxref("VREyeParameters.renderRect")}} de l'API WebVR spécifie la fenêtre d'un élément [canvas](/fr/docs/Web/API/HTMLCanvasElement) dans laquelle le visuel pour un oeil doit être rendu.
Il hérite de son parent {{domxref("DOMRectReadOnly")}}.
{{InheritanceDiagram}}
## Constructeur
- {{domxref("DOMRect.DOMRect","DOMRect()")}}
- : Crée un nouvel objet `DOMRect`.
## Propriétés
_`DOMRect` hérite des propriétés de son parent {{domxref("DOMRectReadOnly")}}. À une différence près, elles ne sont plus en lecture seule._
- {{domxref("DOMRectReadOnly.x")}}
- : La coordonnée x de l'origine du `DOMRect`.
- {{domxref("DOMRectReadOnly.y")}}
- : La coordonnée y de l'origine du `DOMRect`.
- {{domxref("DOMRectReadOnly.width")}}
- : La largeur du `DOMRect`.
- {{domxref("DOMRectReadOnly.height")}}
- : La hauteur du `DOMRect`.
- {{domxref("DOMRectReadOnly.top")}}
- : Renvoie la valeur de la coordonnée supérieure de `DOMRect` (a la même valeur que `y`, ou `y + height` _(y + hauteur)_ si `height` est négative).
- {{domxref("DOMRectReadOnly.right")}}
- : Renvoie la valeur de la coordonnée droite du `DOMRect` (a la même valeur que `x + width` _(x + largeur)_, ou `x` si `width` est négative).
- {{domxref("DOMRectReadOnly.bottom")}}
- : Renvoie la valeur de la coordonnée du bas du `DOMRect` (a la même valeur que `y + height` _(y + hauteur)_, ou `y` si `height` est négative).
- {{domxref("DOMRectReadOnly.left")}}
- : Renvoie la valeur de la coordonnée de gauche du `DOMRect` (a la même valeur que `x`, ou `x + width` _(x + largeur)_ si `width` est négative).
## Méthodes
_`DOMRect` hérite des méthodes de son parent {{domxref("DOMRectReadOnly")}}._
- {{domxref("DOMRectReadOnly.fromRect()")}}
- : Crée un nouvel objet `DOMRect` avec l'emplacement et les dimensions données.
## Spécifications
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------- | -------------------------------------------- | -------------------- |
| {{SpecName('Geometry Interfaces', '#DOMRect', 'DOMRect')}} | {{Spec2('Geometry Interfaces')}} | Définition initiale. |
## Compatibilité des navigateurs
{{Compat("api.DOMRect")}}
## Voir aussi
- {{domxref("DOMPoint")}}
|
