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

Selection:getRangeAt() 方法

· 52CE 我爱测

Selection 接口的 **`getRangeAt()`** 方法会返回一个表示当前选中范围的 Range 对象。

DOM

Selection 接口的 getRangeAt() 方法会返回一个表示当前选中范围的 Range 对象。

如果所选范围的端点位于某个shadow tree中,那么 JavaScript 将无法访问这些影子节点,此方法应当将该范围重新限定为包含该端点的宿主元素。在实际情况下,大多数浏览器尚未实现这一行为,因此返回的范围结果是不可预测的。

[!NOTE] 当在可能包含影子根的节点内进行选择时,可以使用 Selection.getComposedRanges()(如果浏览器支持)来获取位于影子树内的选区范围,或者将选区可靠地重新限定到宿主节点上。

语法

getRangeAt(index)

参数

  • index
    • : 要返回的范围的从零开始的索引。如果该数为负数,或大于等于 Selection.rangeCount,将会导致错误。

返回值

指定的 Range 对象。

示例

let ranges = [];

const sel = window.getSelection();

for (let i = 0; i < sel.rangeCount; i++) {
  ranges[i] = sel.getRangeAt(i);
}
/* ranges 数组中的每一项现在都是一个 range 对象,
 * 用来表示当前选区中的其中一个范围 */

规范

浏览器兼容性

参见

  • 所属的 Selection 接口。

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

资料来源与适用范围

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

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

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