1. Web
  2. Web API
  3. Range
  4. surroundContents()

Range：surroundContents() 方法

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

surroundContents() 方法是 Range 接口的一部分，它使用提供的节点来包裹选中的内容。该方法会 提取 选区的内容，用提取的内容替换 newParent 的子节点，将 newParent 插入 到提取内容的原位置，并使选区选中 newParent。

如果选区部分包含任何非 Text 节点，则会抛出异常。选区只能包含文本节点和完全选中的节点。

语法

js
surroundContents(newParent)

参数

newParent

用于包裹内容的 Node。

返回值

无（undefined）。

示例

HTML

html
<span class="header-text">Put this in a headline</span>

JavaScript

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

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

结果

规范

规范
DOM
# dom-range-surroundcontents

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

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

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