StaticRange

DOM 的 StaticRange 接口继承自 AbstractRange,用于提供一种方法来指定 DOM 中的内容范围,其内容不会更新以反映 DOM 树中发生的更改。

该接口提供与其父接口 AbstractRange 相同的属性和方法集。

AbstractRangeStaticRange 无法从 Web Worker 中获得。

AbstractRange StaticRange

构造函数

StaticRange()

根据指定其属性默认值的选项,创建一个新的 StaticRange 对象。

实例属性

以下属性继承自其父接口 AbstractRange

StaticRange.collapsed 只读

返回一个布尔值,如果范围的开始位置和结束位置相同,则为 true,导致范围长度为 0。

StaticRange.endContainer 只读

返回包含范围结束点的 DOM Node。范围结束点所在的节点偏移量由 endOffset 指示。

StaticRange.endOffset 只读

返回一个整数,指示在 endContainer 给出的节点中找到范围最后一个字符的偏移量。

StaticRange.startContainer 只读

返回包含范围起点的 DOM Node(该起点由 startOffset 标识)。

StaticRange.startOffset 只读

返回一个整数,指示在 startContainer 指定的节点中找到范围第一个字符的偏移量。

使用说明

DOM 范围指定文档中的一段内容,可能从一个节点(或元素)内部开始,并在另一个节点内部结束。与 Range 不同,StaticRange 表示一个固定时间内的范围;它不会改变以尝试在文档更改时保持相同的内容。如果对 DOM 进行任何更改,则由 StaticRange 指定的范围内包含的实际数据可能会更改。这使得 用户代理 能够避免许多不必要的操作,如果 Web 应用程序或网站不需要实时更新范围。

规范

规范
DOM 标准
# interface-staticrange

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅

  • DOM 中内容的实时更新范围:Range
  • AbstractRange,所有范围都从中派生的抽象接口