Range
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Range
接口表示一个包含节点与文本节点的一部分的文档片段。
可以使用 Document.createRange
方法创建 Range。也可以用 Selection
对象的 getRangeAt()
方法或者 Document
对象的 caretRangeFromPoint()
方法获取 Range 对象。
还可以用 Range()
构造函数。
属性
没有继承的属性。
Range.collapsed
只读-
返回一个表示
Range
的起始位置和终止位置是否相同的布尔值
。 Range.commonAncestorContainer
只读-
返回完整包含
startContainer
和endContainer
的、最深一级的节点
。 Range.endContainer
只读-
返回包含
Range
终点的节点
。 Range.endOffset
只读-
返回一个表示
Range
终点在endContainer
中的位置的数字。 Range.startContainer
只读-
返回包含
Range
开始的节点
。 Range.startOffset
只读-
返回一个数字,表示
Range
在startContainer
中的起始位置。
构造函数
方法
该接口没有继承的方法。
Range.collapse()
-
将
Range
折叠到其边界的端点。 Range.compareBoundaryPoints()
-
将该
Range
的边界与另一个Range
的边界进行比较 Range.compareNode()
已弃用 非标准-
返回一个常量,表示
节点
是否在Range
的前、后、中、外。 Range.comparePoint()
-
返回 -1、0 或 1,分别表示端点在
Range
之前、内部还是之后。 Range.cloneContents()
-
返回一个复制
Range
中所有节点的文档片段
。 Range.cloneRange()
-
返回一个拥有和原
Range
对象相同端点的克隆的Range
对象。 Range.createContextualFragment()
-
返回从给定的代码字符串创建的
文档片段
。 Range.deleteContents()
-
从
Document
中移除Range
内容。 Range.detach()
-
将
Range
从使用状态释放,提高性能。 Range.extractContents()
-
将
Range
的内容从文档树移动到一个文档片段
。 Range.getBoundingClientRect()
-
返回一个
DOMRect
对象,其绑定了Range
的整个内容;这将是通过range.getClientRects()
返回所有边界矩形集合的其中之一。 Range.getClientRects()
-
返回一个
DOMRect
列表对象,该列表汇总了Range
中所有元素的Element.getClientRects()
返回结果。 Range.isPointInRange()
-
返回一个
boolean
,表示给点端点是否在Range
中。 Range.insertNode()
-
在
Range
开头插入一个节点
。 Range.intersectsNode()
-
返回一个
boolean
,表示给定的节点是否与Range
相交。 Range.selectNode()
-
设置
Range
包含某个节点
及其他的内容。 Range.selectNodeContents()
-
设置
Range
包含某个节点
的内容。 Range.setEnd()
-
设置
Range
的终点。 Range.setStart()
-
设置
Range
的起点。 Range.setEndAfter()
-
以另一个
节点
为基准,设置Range
的终点位置。 Range.setEndBefore()
-
以另一个
节点
为基准,设置Range
的终点位置。 Range.setStartAfter()
-
以另一个
节点
为基准,设置Range
的起点位置。 Range.setStartBefore()
-
以另一个
节点
为基准,设置Range
的起点位置。 Range.surroundContents()
-
将
Range
中的内容移动到一个新的节点
。 Range.toString()
-
返回
Range
中的文本
规范
Specification |
---|
DOM Standard # interface-range |
DOM Parsing and Serialization # extensions-to-the-range-interface |
CSSOM View Module # extensions-to-the-range-interface |
浏览器兼容性
BCD tables only load in the browser