Range.getBoundingClientRect()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

这是实验性技术
检查浏览器兼容性表格要小心谨慎在生产中使用这之前。

Range.getBoundingClientRect() 方法返回 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.

句法

boundingRect = range.getBoundingClientRect()

范例

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`;

结果

规范

规范	状态	注释
CSSOM (CSS 对象模型) 视图模块 The definition of 'Range.getBoundingClientRect()' in that specification.	工作草案	最初的规范。

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`getBoundingClientRect`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 15	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android 14	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
实验。期望将来行为有所改变。

另请参阅

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.

元数据

最后修改： May 8, 2019

DOM (文档对象模型)
范围
构造函数
1. Range()
特性
方法
1. cloneContents()
2. cloneRange()
3. collapse()
4. compareBoundaryPoints()
5. ~~compareNode()~~
6. comparePoint()
7. createContextualFragment()
8. deleteContents()
9. detach()
10. extractContents()
11. getBoundingClientRect()
12. getClientRects()
13. insertNode()
14. intersectsNode()
15. isPointInRange()
16. selectNode()
17. selectNodeContents()
18. setEnd()
19. setEndAfter()
20. setEndBefore()
21. setStart()
22. setStartAfter()
23. setStartBefore()
24. surroundContents()
25. toString()
继承：
1. AbstractRange
DOM 相关页面

在此页

句法

范例

HTML

CSS

JavaScript

结果

规范

浏览器兼容性

图例

另请参阅

相关话题