DOM
Range 接口表示一个包含节点与文本节点的一部分的文档片段。
可以使用 Document.createRange 方法创建 Range。也可以用 Selection 对象的 Selection/getRangeAt 方法或者 Document 对象的 Document/caretRangeFromPoint 方法获取 Range 对象。
还可以用 Range.Range() 构造函数。
属性
没有继承的属性。
- Range.collapsed
- : 返回一个表示
Range的起始位置和终止位置是否相同的Boolean。
- : 返回一个表示
- Range.commonAncestorContainer
- : 返回完整包含
startContainer和endContainer的、最深一级的Node。
- : 返回完整包含
- Range.endContainer
- : 返回包含
Range终点的Node。
- : 返回包含
- Range.endOffset
- : 返回一个表示
Range终点在endContainer中的位置的数字。
- : 返回一个表示
- Range.startContainer
- : 返回包含
Range开始的Node。
- : 返回包含
- Range.startOffset
- : 返回一个数字,表示
Range在startContainer中的起始位置。
- : 返回一个数字,表示
构造函数
- Range.Range()
- : 返回一个以全局(global)Document 作为起点与终点的
Range对象。
- : 返回一个以全局(global)Document 作为起点与终点的
方法
该接口没有继承的方法。
- Range.collapse()
- : 将
Range折叠到其边界的端点。
- : 将
- Range.compareBoundaryPoints()
- : 将该
Range的边界与另一个Range的边界进行比较
- : 将该
- Range.compareNode()
- : 返回一个常量,表示Node是否在
Range的前、后、中、外。
- : 返回一个常量,表示Node是否在
- Range.comparePoint()
- : 返回 -1、0 或 1,分别表示端点在
Range之前、内部还是之后。
- : 返回 -1、0 或 1,分别表示端点在
- Range.cloneContents()
- : 返回一个复制
Range中所有节点的DocumentFragment。
- : 返回一个复制
- Range.cloneRange()
- : 返回一个拥有和原
Range对象相同端点的克隆的Range对象。
- : 返回一个拥有和原
- Range.createContextualFragment()
- : 返回从给定的代码字符串创建的DocumentFragment。
- Range.deleteContents()
- : 从 Document 中移除
Range内容。
- : 从 Document 中移除
- Range.detach()
- : 将
Range从使用状态释放,提高性能。
- : 将
- Range.extractContents()
- : 将
Range的内容从文档树移动到一个DocumentFragment。
- : 将
- Range.getBoundingClientRect()
- : 返回一个 DOMRect 对象,其绑定了
Range的整个内容;这将是通过 range.getClientRects() 返回所有边界矩形集合的其中之一。
- : 返回一个 DOMRect 对象,其绑定了
- Range.getClientRects()
- : 返回一个 DOMRect 列表对象,该列表汇总了
Range中所有元素的 Element.getClientRects() 返回结果。
- : 返回一个 DOMRect 列表对象,该列表汇总了
- Range.isPointInRange()
- : 返回一个
boolean,表示给点端点是否在Range中。
- : 返回一个
- Range.insertNode()
- : 在
Range开头插入一个Node。
- : 在
- Range.intersectsNode()
- : 返回一个
boolean,表示给定的节点是否与Range相交。
- : 返回一个
- Range.selectNode()
- : 设置
Range包含某个Node及其他的内容。
- : 设置
- Range.selectNodeContents()
- : 设置
Range包含某个Node的内容。
- : 设置
- Range.setEnd()
- : 设置
Range的终点。
- : 设置
- Range.setStart()
- : 设置
Range的起点。
- : 设置
- Range.setEndAfter()
- : 以另一个Node为基准,设置
Range的终点位置。
- : 以另一个Node为基准,设置
- Range.setEndBefore()
- : 以另一个Node为基准,设置
Range的终点位置。
- : 以另一个Node为基准,设置
- Range.setStartAfter()
- : 以另一个Node为基准,设置
Range的起点位置。
- : 以另一个Node为基准,设置
- Range.setStartBefore()
- : 以另一个Node为基准,设置
Range的起点位置。
- : 以另一个Node为基准,设置
- Range.surroundContents()
- : 将
Range中的内容移动到一个新的Node。
- : 将
- Range.toString()
- : 返回
Range中的文本
- : 返回
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
