This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The Range.getBoundingClientRect()
method returns a DOMRect
object that bounds the contents of the range; this is a rectangle enclosing the union of the bounding rectangles for all the elements in the range.
This method is useful for determining the viewport coordinates of the cursor or selection inside a text box. See Element.getBoundingClientRect()
for details on the returned value.
Syntax
boundingRect = range.getBoundingClientRect()
Example
HTML
<div id="highlight"></div> <p>This example positions a "highlight" rectangle behind the contents of a range. The range's content <b>starts here</b> and continues on until it <b>ends here</b>. The bounding client rectangle contains everything selected in the range.</p>
CSS
#highlight { background: yellow; position: absolute; z-index: -1; } p { width: 200px; }
JavaScript
const range = document.createRange(); range.setStartBefore(document.getElementsByTagName('b').item(0), 0); range.setEndAfter(document.getElementsByTagName('b').item(1), 0); const clientRect = range.getBoundingClientRect(); const highlight = document.getElementById('highlight'); highlight.style.left = `${clientRect.x}px`; highlight.style.top = `${clientRect.y}px`; highlight.style.width = `${clientRect.width}px`; highlight.style.height = `${clientRect.height}px`;
Result
Specification
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) View Module The definition of 'Range.getBoundingClientRect()' in that specification. |
Working Draft | Initial specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getBoundingClientRect | Chrome Full support Yes | Edge Full support 12 | Firefox Full support 4 | IE Full support 9 | Opera Full support 15 | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 4 | Opera Android Full support 14 | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
See also
Range.getClientRects()
- finer-grained result for non-rectangular ranges (e.g., when the selection wraps onto the next line);Element.getBoundingClientRect()
Document.caretPositionFromPoint()
- to get the (node, offset) from viewport coordinates.