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

Range:surroundContents() 方法

· 52CE 我爱测

`Range.surroundContents()`** 方法将 Range 的内容移动到一个新节点,并将该新节点放置在范围所指定的起始位置。

DOM

Range.surroundContents() 方法将 Range 的内容移动到一个新节点,并将该新节点放置在范围所指定的起始位置。

此方法几乎等同于 newNode.appendChild(range.extractContents()); range.insertNode(newNode)。在包围操作之后,range 的边界点将包含 newNode。

如果 Range 只用其中一个边界点分割了一个非 Text 节点,则会抛出异常。也就是说,与上述方案不同的是,如果有部分节点被选中,它们将不会被克隆,相反,操作会失败。

语法

surroundContents(newParent)

参数

  • newParent
    • : 用于包围内容的 Node。

返回值

无(undefined)。

示例

HTML

<span class="header-text">在标题中写道</span>

JavaScript

const range = document.createRange();
const newParent = document.createElement("h1");

range.selectNode(document.querySelector(".header-text"));
range.surroundContents(newParent);

结果

示例

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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