1. Web
  2. Web API
  3. StaticRange

StaticRange

Baseline 已广泛支持

此特性已经十分成熟，可在许多设备和浏览器版本上使用。自 2020 年 7 月以来，它已在各大浏览器中可用。

StaticRange 接口扩展了 AbstractRange，提供了一种指定 DOM 中内容范围的方法，该范围的内容不会更新以反映 DOM 树内发生的变化。

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

AbstractRange 和 StaticRange 不能从 Web Workers 中访问。

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

浏览器兼容性

另见

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

帮助改进 MDN

了解如何贡献

此页面最后修改于 ，由 MDN 贡献者 修改。

在 GitHub 上查看此页面 • 报告此内容的错误
© . Content available under a Creative Commons license.