Array

The Element.getBoundingClientRect() method returns a DOMRect object providing information about the kích cỡ of an element & its position relative to the viewport.

Bạn đang xem: Array


The returned value is a DOMRect object which is the smallest rectangle which contains the entire element, including its padding và border-width. The left, top, right, bottom, x, y, width, and height properties describe the position và form size of the overall rectangle in pixels. Properties other than width & height are relative lớn the top-left of the viewport.

*

The width and height properties of theDOMRect object returned by the method include the padding and border-width, not only the content width/height. In the standard box Model, this would be equal lớn thewidth or height property of the element + padding+border-width. But ifbox-sizing: border-box is set for the element this would be directly equal lớn itswidth or height.

The returned value can be thought of as the union of the rectangles returned by getClientRects() for the element, i.e., the CSS border-boxes associated with the element.

Empty border-boxes are completely ignored. If all the element"s border-boxes are empty, then a rectangle is returned with a width và height of zero và where the top và left are the top-left of the border-box for the first CSS box (in content order) for the element.

The amount of scrolling that has been done of the viewport area (or any other scrollable element) is taken inlớn tài khoản when computing the bounding rectangle. This means that the rectangle"s boundary edges (top, right, bottom, left) change their values every time the scrolling position changes (because their values are relative lớn the viewport and not absolute).

Xem thêm: Intel Chipset Driver Là Gì ? Tìm Hiểu Chi Tiết Về Chipset Chipset Là Gì

If you need the bounding rectangle relative sầu to lớn the top-left corner of the document, just add the current scrolling position lớn the top and left properties (these can be obtained using window.scrollX và window.scrollY) lớn get a bounding rectangle which is independent from the current scrolling position.


Cross-browser fallback


Scripts requiring high cross-browser compatibility can use window.pageXOffmix and window.pageYOffset instead of window.scrollX and window.scrollY. Scripts without access lớn these properties can use code lượt thích this:


// For scrollX(((t = document.documentElement) || (t = document.toàn thân.parentNode)) && typeof t.scrollLeft == "number" ? t : document.body).scrollLeft// For scrollY(((t = document.documentElement) || (t = document.toàn thân.parentNode)) && typeof t.scrollTop == "number" ? t : document.body).scrollTop

Examples


Basic


This simple example retrieves the DOMRect object representing the bounding client rect of a simple
element, and prints out its properties below it.


div>div>
The returned DOMRect object can be modified in modern browsers. This was not true with older versions which effectively returned DOMRectReadOnly. With IE and Edge, not being able to lớn add missing properties to lớn their returned ClientRect, object prevents backfilling x và y.

Due khổng lồ compatibility problems (see below), it is safest lớn rely on only properties left, top, right, và bottom.

Properties in the returned DOMRect object are not own properties. While the in operator và for...in will find returned properties, other APIs such as Object.keys() will fail. Moreover, & unexpectedly, the ESnăm ngoái & newer features such as Object.assign() and object rest/spread will fail to lớn copy returned properties.


rect = elt.getBoundingClientRect()// The result in emptyObj is emptyObj = Object.assign(, rect)emptyObj = ...rect width, ...emptyObj = rect
DOMRect properties top,left, right, & bottom are computed using the values of the object"s other properties.