W3cubDocs

/Web APIs

Range: getClientRects() method

The Range.getClientRects() method returns a list of DOMRect objects representing the area of the screen occupied by the range. This is created by aggregating the results of calls to Element.getClientRects() for all the elements in the range.

Syntax

js

getClientRects()

Parameters

None.

Return value

An iterable sequence of DOMRect objects.

Examples

Logging selected client rect sizes

HTML

html

<div></div>
<pre id="output"></pre>

CSS

css

div {
  height: 80px;
  width: 200px;
  background-color: blue;
}

JavaScript

js

const range = document.createRange();
range.selectNode(document.querySelector("div"));
rectList = range.getClientRects();

const output = document.querySelector("#output");
for (const rect of rectList) {
  output.textContent = `${output.textContent}\n${rect.width}:${rect.height}`;
}

Result

Specifications

Specification
CSSOM View Module
# dom-range-getclientrects

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
getClientRects 4 12 4 9 ≤12.1 5 ≤37 18 4 ≤12.1 4 1.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Range/getClientRects