View in EnglishAlways switch to English

Range

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

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(): 返回一个以全局（global）Document 作为起点与终点的Range 对象。

方法

该接口没有继承的方法。

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 中的文本