Range
Range 接口表示一个包含节点与文本节点的一部分的文档片段。
可以使用 Document.createRange 方法创建 Range。也可以用 Selection 对象的 getRangeAt() 方法或者 Document 对象的 caretRangeFromPoint() 方法获取 Range 对象。
还可以用 Range() 构造函数。
属性
没有继承的属性。
Range.collapsed只读-
返回一个表示
Range的起始位置和终止位置是否相同的布尔值(en-US)。 Range.commonAncestorContainer只读-
返回完整包含
startContainer和endContainer的、最深一级的节点。 Range.endContainer只读-
返回包含
Range终点的节点。 Range.endOffset只读-
返回一个表示
Range终点在endContainer中的位置的数字。 Range.startContainer只读-
返回包含
Range开始的节点。 Range.startOffset只读-
返回一个数字,表示
Range在startContainer中的起始位置。
构造函数
方法
该接口没有继承的方法。
Range.collapse()-
将
Range折叠到其边界的端点。 Range.compareBoundaryPoints()(en-US)-
将该
Range的边界与另一个Range的边界进行比较 Range.compareNode()(en-US) 已弃用 非标准-
返回一个常量,表示
节点是否在Range的前、后、中、外。 Range.comparePoint()(en-US)-
返回 -1、0 或 1,分别表示端点在
Range之前、内部还是之后。 Range.cloneContents()-
返回一个复制
Range中所有节点的文档片段。 Range.cloneRange()-
返回一个拥有和原
Range对象相同端点的克隆的Range对象。 Range.createContextualFragment()-
返回从给定的代码字符串创建的
文档片段。 Range.deleteContents()-
从
Document中移除Range内容。 Range.detach()(en-US)-
将
Range从使用状态释放,提高性能。 Range.extractContents()-
将
Range的内容从文档树移动到一个文档片段。 Range.getBoundingClientRect()-
返回一个
DOMRect对象,其绑定了Range的整个内容;这将是通过range.getClientRects()返回所有边界矩形集合的其中之一。 Range.getClientRects()-
返回一个
DOMRect列表对象,该列表汇总了Range中所有元素的Element.getClientRects()返回结果。 Range.isPointInRange()(en-US)-
返回一个
boolean,表示给点端点是否在Range中。 Range.insertNode()-
在
Range开头插入一个节点。 Range.intersectsNode()-
返回一个
boolean,表示给定的节点是否与Range相交。 Range.selectNode()-
设置
Range包含某个节点及其他的内容。 Range.selectNodeContents()-
设置
Range包含某个节点的内容。 Range.setEnd()-
设置
Range的终点。 Range.setStart()-
设置
Range的起点。 Range.setEndAfter()(en-US)-
以另一个
节点为基准,设置Range的终点位置。 Range.setEndBefore()(en-US)-
以另一个
节点为基准,设置Range的终点位置。 Range.setStartAfter()(en-US)-
以另一个
节点为基准,设置Range的起点位置。 Range.setStartBefore()-
以另一个
节点为基准,设置Range的起点位置。 Range.surroundContents()-
将
Range中的内容移动到一个新的节点。 Range.toString()(en-US)-
返回
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