大网数据广告活动
Web 标准与前端开发

Range

· 52CE 我爱测

可以使用 Document.createRange 方法创建 Range。也可以用 Selection 对象的 Selection/getRangeAt 方法或者 Document 对象的 Document/caretRangeFromPoint 方法获取 Range 对象。

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 对象。

方法

该接口没有继承的方法。

  • Range.collapse()
    • : 将 Range 折叠到其边界的端点。
  • Range.compareBoundaryPoints()
    • : 将该 Range 的边界与另一个 Range 的边界进行比较
  • Range.compareNode()
    • : 返回一个常量,表示Node是否在 Range 的前、后、中、外。
  • Range.comparePoint()
    • : 返回 -1、0 或 1,分别表示端点在 Range 之前、内部还是之后。
  • Range.cloneContents()
    • : 返回一个复制 Range 中所有节点的DocumentFragment。
  • Range.cloneRange()
    • : 返回一个拥有和原 Range 对象相同端点的克隆的 Range 对象。
  • Range.createContextualFragment()
    • : 返回从给定的代码字符串创建的DocumentFragment。
  • Range.deleteContents()
    • : 从 Document 中移除 Range 内容。
  • Range.detach()
    • : 将 Range 从使用状态释放,提高性能。
  • Range.extractContents()
    • : 将 Range 的内容从文档树移动到一个DocumentFragment。
  • Range.getBoundingClientRect()
    • : 返回一个 DOMRect 对象,其绑定了 Range 的整个内容;这将是通过 range.getClientRects() 返回所有边界矩形集合的其中之一。
  • Range.getClientRects()
    • : 返回一个 DOMRect 列表对象,该列表汇总了 Range 中所有元素的 Element.getClientRects() 返回结果。
  • 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 的终点位置。
  • Range.setEndBefore()
    • : 以另一个Node为基准,设置 Range 的终点位置。
  • Range.setStartAfter()
    • : 以另一个Node为基准,设置 Range 的起点位置。
  • Range.setStartBefore()
    • : 以另一个Node为基准,设置 Range 的起点位置。
  • Range.surroundContents()
    • : 将 Range 中的内容移动到一个新的Node。
  • Range.toString()
    • : 返回 Range 中的文本

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。