Range
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