DOMRect

{{APIRef("Geometry Interfaces")}}{{AvailableInWorkers}}

A DOMRect describes the size and position of a rectangle.

The type of box represented by the DOMRect is specified by the method or property that returned it. For example, {{domxref("Range.getBoundingClientRect()")}} specifies the rectangle that bounds the content of the range using such objects.

It inherits from its parent, {{domxref("DOMRectReadOnly")}}.

{{InheritanceDiagram}}

Constructor

• {{domxref("DOMRect.DOMRect","DOMRect()")}}
  • : Creates a new DOMRect object.

Instance properties

DOMRect inherits properties from its parent, {{domxref("DOMRectReadOnly")}}. The difference is that they are not read-only anymore.

• {{domxref("DOMRect.x")}}
  • : The x coordinate of the DOMRect's origin (typically the top-left corner of the rectangle).
• {{domxref("DOMRect.y")}}
  • : The y coordinate of the DOMRect's origin (typically the top-left corner of the rectangle).
• {{domxref("DOMRect.width")}}
  • : The width of the DOMRect.
• {{domxref("DOMRect.height")}}
  • : The height of the DOMRect.
• {{domxref("DOMRectReadOnly.top")}}
  • : Returns the top coordinate value of the DOMRect (has the same value as y, or y + height if height is negative).
• {{domxref("DOMRectReadOnly.right")}}
  • : Returns the right coordinate value of the DOMRect (has the same value as x + width, or x if width is negative).
• {{domxref("DOMRectReadOnly.bottom")}}
  • : Returns the bottom coordinate value of the DOMRect (has the same value as y + height, or y if height is negative).
• {{domxref("DOMRectReadOnly.left")}}
  • : Returns the left coordinate value of the DOMRect (has the same value as x, or x + width if width is negative).

Static methods

DOMRect may also inherit static methods from its parent, {{domxref("DOMRectReadOnly")}}.

• {{domxref("DOMRect/fromRect_static", "DOMRect.fromRect()")}}
  • : Creates a new DOMRect object with a given location and dimensions.

Instance methods

DOMRect may inherit methods from its parent, {{domxref("DOMRectReadOnly")}}.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("DOMPoint")}}