---
title: DOMRect
slug: Web/API/DOMRect
translation_of: Web/API/DOMRect
---
<p>{{draft}}{{APIRef("Geometry Interfaces")}}</p>

<p>一个 <strong><code>DOMRect</code></strong> 代表一个矩形。</p>

<p><code>DOMRect</code> 表示的盒子的类型由返回它的方法或属性指定。例如，WebVR API 的 {{domxref("VREyeParameters.renderRect")}} 指定了头戴式显示器的一只眼睛应该呈现的影像所在的 <a href="/en-US/docs/Web/API/HTMLCanvasElement">canvas</a> 的视口。</p>

<p>它继承自它的父类，{{domxref("DOMRectReadOnly")}}。</p>

<p>{{InheritanceDiagram}}</p>

<h2 id="构造函数">构造函数</h2>

<dl>
 <dt>{{domxref("DOMRect.DOMRect","DOMRect()")}}</dt>
 <dd>创建一个新的 <code>DOMRect</code> 对象。</dd>
</dl>

<h2 id="属性">属性</h2>

<dl>
</dl>

<p><code>DOMRect</code> 从其父类 <em>{{domxref("DOMRectReadOnly")}}</em> 继承属性。不同之处在于它们不再是只读的。</p>

<dl>
 <dt>{{domxref("DOMRectReadOnly.x")}}</dt>
 <dd><code>DOMRect</code> 原点的 x 坐标。</dd>
 <dt>{{domxref("DOMRectReadOnly.y")}}</dt>
 <dd><code>DOMRect</code> 原点的 y 坐标。</dd>
 <dt>{{domxref("DOMRectReadOnly.width")}}</dt>
 <dd><code>DOMRect</code> 的宽度。</dd>
 <dt>{{domxref("DOMRectReadOnly.height")}}</dt>
 <dd><code>DOMRect</code> 的高度。</dd>
 <dt>{{domxref("DOMRectReadOnly.top")}}</dt>
 <dd>返回 <code>DOMRect</code> 的顶坐标值（与 <code>y</code> 具有相同的值，如果 <code>height</code> 为负值，则为 <code>y + height</code> 的值）。</dd>
 <dt>{{domxref("DOMRectReadOnly.right")}}</dt>
 <dd>返回 <code>DOMRect</code> 的右坐标值（与 <code>x + width</code> 具有相同的值，如果<code>width</code> 为负值，则为 <code>x</code> 的值）。</dd>
 <dt>{{domxref("DOMRectReadOnly.bottom")}}</dt>
 <dd>返回 <code>DOMRect</code> 的底坐标值（与 <code>y + height</code> 具有相同的值，如果 <code>height</code> 为负值，则为 <code>y</code> 的值）。</dd>
 <dt>{{domxref("DOMRectReadOnly.left")}}</dt>
 <dd>返回 <code>DOMRect</code> 的左坐标值（与 <code>x</code> 具有相同的值，如果 <code>width</code> 为负值，则为 <code>x + width</code> 的值）。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em><code>DOMRect</code> 从它的父类继承方法，{{domxref("DOMRectReadOnly")}}。</em></p>

<dl>
 <dt>
 <h2 id="静态方法">静态方法</h2>
 </dt>
 <dt>{{domxref("DOMRectReadOnly.fromRect()")}}</dt>
 <dd>创建一个具有指定位置和尺寸的新 <code>DOMRect</code> 对象。</dd>
</dl>

<h2 id="Specification" name="Specification">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Geometry Interfaces', '#DOMRect', 'DOMRect')}}</td>
   <td>{{Spec2('Geometry Interfaces')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("api.DOMRect")}}</p>

<h2 id="更多">更多</h2>

<ul>
 <li>{{domxref("DOMPoint")}}</li>
</ul>