From ac4bacbf4c7e5cf0234a6c7a706171ec9535f2ed Mon Sep 17 00:00:00 2001
From: T34-active <a591342974@gmail.com>
Date: Wed, 21 Aug 2024 11:02:48 +0800
Subject: [PATCH 1/2] [zh-cn]: update the translation of Range
 `surroundContents()` method

---
 .../web/api/range/surroundcontents/index.md   | 34 +++++++++++--------
 1 file changed, 20 insertions(+), 14 deletions(-)

diff --git a/files/zh-cn/web/api/range/surroundcontents/index.md b/files/zh-cn/web/api/range/surroundcontents/index.md
index 31d62998592665..c147f84b362773 100644
--- a/files/zh-cn/web/api/range/surroundcontents/index.md
+++ b/files/zh-cn/web/api/range/surroundcontents/index.md
@@ -1,42 +1,48 @@
 ---
-title: Range.surroundContents
+title: Range：surroundContents() 方法
 slug: Web/API/Range/surroundContents
+l10n:
+  sourceCommit: 1a91b0b63f0cbaca9125bd48d4e5bc8afed2a7a3
 ---
 
-{{ ApiRef("Range") }}
+{{ApiRef("DOM")}}
 
-**`Range.surroundContents()`** 方法将 {{ domxref("Range") }} 对象的内容移动到一个新的节点，并将新节点放到这个范围的起始处。
+**`Range.surroundContents()`** 方法将 {{ domxref("Range") }} 的内容移动到一个新节点，并将该新节点放置在指定的起始位置。
 
-这个方法与 `newNode.appendChild(range.extractContents()); range.insertNode(newNode)` 等价。应用以后， `newNode` 包含在 `range` 的边界点中。
+此方法几乎等同于 `newNode.appendChild(range.extractContents()); range.insertNode(newNode)`。在包围操作之后，`range` 的边界点将包含 `newNode`。
 
-然而，如果 {{ domxref("Range") }} 断开了一个非 {{ domxref("Text") }} 节点，只包含了节点的其中一个边界点，就会抛出异常。也就是说，不像上述的等价方法，如果节点仅有一部分被选中，则不会被克隆，整个操作会失败。
+如果 {{ domxref("Range") }} 只用其中一个边界点分割了一个非 {{domxref("Text") }} 节点，则会抛出异常。也就是说，与上述方案不同的是，如果有部分节点被选中，它们将不会被克隆，相反，操作会失败。
 
 ## 语法
 
-```plain
-range.surroundContents(newParent);
+```js-nolint
+surroundContents(newParent)
 ```
 
 ### 参数
 
 - `newParent`
-  - : 一个包含内容的 {{ domxref("Node") }}。
+  - : 用于包围内容的 {{ domxref("Node") }}。
+
+### 返回值
+
+无（{{jsxref("undefined")}}）。
 
 ## 示例
 
 ### HTML
 
-```plain
-<span class="header-text">Put this in a headline</span>
+```html
+<span class="header-text">在标题中写道</span>
 ```
 
 ### JavaScript
 
-```plain
+```js
 const range = document.createRange();
-const newParent = document.createElement('h1');
+const newParent = document.createElement("h1");
 
-range.selectNode(document.querySelector('.header-text'));
+range.selectNode(document.querySelector(".header-text"));
 range.surroundContents(newParent);
 ```
 
@@ -54,4 +60,4 @@ range.surroundContents(newParent);
 
 ## 参见
 
-- [The DOM interfaces index](/zh-CN/docs/DOM/DOM_Reference)
+- [DOM 接口索引](/zh-CN/docs/Web/API/Document_Object_Model)

From be88fc24b578aee4be72c994edc2279d87649eae Mon Sep 17 00:00:00 2001
From: A1lo <yin199909@aliyun.com>
Date: Wed, 21 Aug 2024 22:19:38 +0800
Subject: [PATCH 2/2] Update
 files/zh-cn/web/api/range/surroundcontents/index.md

---
 files/zh-cn/web/api/range/surroundcontents/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/zh-cn/web/api/range/surroundcontents/index.md b/files/zh-cn/web/api/range/surroundcontents/index.md
index c147f84b362773..4c5d75f0f9f8a8 100644
--- a/files/zh-cn/web/api/range/surroundcontents/index.md
+++ b/files/zh-cn/web/api/range/surroundcontents/index.md
@@ -7,7 +7,7 @@ l10n:
 
 {{ApiRef("DOM")}}
 
-**`Range.surroundContents()`** 方法将 {{ domxref("Range") }} 的内容移动到一个新节点，并将该新节点放置在指定的起始位置。
+**`Range.surroundContents()`** 方法将 {{ domxref("Range") }} 的内容移动到一个新节点，并将该新节点放置在范围所指定的起始位置。
 
 此方法几乎等同于 `newNode.appendChild(range.extractContents()); range.insertNode(newNode)`。在包围操作之后，`range` 的边界点将包含 `newNode`。