本文深入探讨了如何使用原生 JavaScript 的 Selection 和 Range API，在富文本编辑器或任何可编辑的 HTML 区域中精确地替换或修改用户选定的文本。通过获取当前选区、提取其内容、创建新的替换节点并将其插入原位置，我们能够实现对页面内容的动态、精确控制，无需依赖 jQuery 等库。文章提供了详细的步骤、示例代码及注意事项，帮助开发者有效管理用户交互产生的文本选区操作。
引言
在现代 Web 应用中，富文本编辑器（如 NicEdit、TinyMCE、Quill 等）已成为不可或缺的组成部分，它们允许用户以所见即所得（WYSIWYG）的方式编辑内容。然而，在这些编辑器中对用户选定的文本进行精确的查找、替换或格式化操作，往往需要深入理解浏览器提供的 Selection 和 Range API。本文将详细介绍如何利用这些原生 JavaScript API，在不依赖任何第三方库的情况下，实现对 HTML 选定文本的替换与修改，特别适用于处理富文本编辑器内部的内容。
核心概念：Selection 和 Range API
在 Web 浏览器中，当用户通过鼠标或键盘选择页面上的文本时，浏览器会创建一个“选区”（Selection）。这个选区可以通过 window.getSelection() 方法获取，它返回一个 Selection 对象。一个 Selection 对象可以包含一个或多个“范围”（Range），但通常情况下，用户通过鼠标拖拽只会创建一个单一的范围。
Range 对象是 Selection API 的核心，它代表文档中一个连续的区域。这个区域可以包含文本节点、元素节点或它们的混合。通过操作 Range 对象，我们可以精确地获取、修改或删除选区内的内容。
立即学习“Java免费学习笔记（深入）”；
关键方法：
- window.getSelection(): 返回一个 Selection 对象，表示用户当前选择的文本范围或光标位置。
- Selection.getRangeAt(index): 从 Selection 对象中获取一个 Range 对象。index 通常为 0，因为大多数情况下只有一个选区。
- Range.extractContents(): 从文档中移除 Range 的内容，并将其作为一个 DocumentFragment 返回。这个方法非常有用，因为它允许我们在不直接操作 DOM 的情况下处理选区内容。
- Range.deleteContents(): 从文档中删除 Range 的内容。
- Range.insertNode(node): 在 Range 的起始位置插入一个 Node。
实现选区文本的替换与修改
要实现对选定文本的替换或修改，通常遵循以下步骤：
- 获取当前选区： 使用 window.getSelection() 获取 Selection 对象。
- 获取选区范围： 从 Selection 对象中获取 Range 对象（通常是第一个）。
- 提取选区内容： 使用 range.extractContents() 将选定内容从 DOM 中移除并获取其副本。
-
创建新的替换节点： 根据需求，创建一个新的 HTML 元素（如 、）或文本节点，用于承载替换后的内容。
- 处理并填充新节点： 将提取的内容（或其文本内容）进行处理，然后填充到新创建的节点中。
- 删除原始选区内容： 如果在第三步中没有使用 extractContents()（它会移除内容），则需要使用 range.deleteContents() 显式删除。
- 插入新节点： 使用 range.insertNode() 将新创建的节点插入到原始选区的位置。
示例代码：将选定文本封装并标记
下面的示例演示了一个具体的应用场景：用户选中一段文本后，点击按钮，选中的文本会被一个带有特定标记的 元素包裹。这相当于对选定内容进行了一种“替换”——用一个带有新结构的元素替换了原始的纯文本或现有结构。
假设我们有一个可编辑的 div 区域，其中包含一些文本，我们希望选中其中的一部分，然后点击按钮将其标记。
HTML 结构：
selectionRange.range.endContainer.innerHTML = newParent.innerHTML;JavaScript 函数 (markSelectedText)：
function markSelectedText() { // 1. 获取当前选区 const selection = window.getSelection(); // 检查是否有选区，并且选区是否在可编辑区域内 if (!selection.rangeCount) return; const range = selection.getRangeAt(0); const editableDiv = document.getElementById('editableContent'); // 确保选区在我们的可编辑区域内，防止意外操作页面其他部分 if (!editableDiv.contains(range.commonAncestorContainer)) { console.warn("选区不在指定的编辑区域内。"); return; } // 2. 提取选区内容 // extractContents() 会将选区内容从 DOM 中移除，并返回一个 DocumentFragment const selectedContentFragment = range.extractContents(); // 3. 创建新的替换节点 (一个 span 元素) const span = document.createElement("span"); // 4. 处理并填充新节点 // 这里我们将提取的文本内容用特定的标记 {{C1::...}} 包裹 // 如果 selectedContentFragment 包含多个节点，selectedContentFragment.textContent 会合并它们的文本 span.innerHTML = `{{C1::${selectedContentFragment.textContent}}}`; span.style.backgroundColor = 'yellow'; // 可添加样式以突出显示 // 5. 插入新节点 // 由于 extractContents() 已经移除了原始内容，这里直接插入新创建的 span 即可 range.insertNode(span); // 清除选区，使页面看起来更干净 selection.removeAllRanges(); }代码解析：
- window.getSelection() 获取当前的 Selection 对象。
- selection.getRangeAt(0) 获取用户选定的第一个 Range。
- range.extractContents() 是这里的关键。它将选定区域内的所有节点（文本、HTML 元素等）从 DOM 中剪切下来，并返回一个 DocumentFragment。此时，原始选区在 DOM 中已经消失。
- 我们创建一个新的 元素。
- span.innerHTML = \{{C1::${selectedContentFragment.textContent}}}`：这一步将DocumentFragment中所有文本内容的合并结果（textContent）取出，并用{{C1::...}}这样的特定标记包裹起来，然后赋值给新的innerHTML。这意味着我们实际上是用一个新的替换了原始选区的内容，并且` 内部的文本是原始文本的修改版本。
- range.insertNode(span)：最后，将这个新的 元素插入到之前 range 所在的起始位置。
通过这种方式，我们不仅替换了选定文本，还对其内容进行了结构化和标记。
注意事项与最佳实践
- 浏览器兼容性： Selection 和 Range API 在现代浏览器中得到了广泛支持。然而，在处理一些复杂的边缘情况时，仍需进行跨浏览器测试。
-
处理复杂 HTML 选区： 当选区包含复杂的 HTML 结构（如嵌套的 div、p 标签）时，extractContents() 返回的 DocumentFragment 会保留这些结构。如果你的替换逻辑需要扁平化内容（如示例中只取 textContent），请确保这种处理符合预期。如果需要保留原始结构并进行包装，可以尝试将 selectedContentFragment 直接 appendChild 到新创建的 span 中。
// 另一种处理方式：保留原始结构并包装 // const span = document.createElement("span"); // span.appendChild(selectedContentFragment); // 将提取的 DocumentFragment 作为子节点插入 // span.style.backgroundColor = 'yellow'; // range.insertNode(span); - 与富文本编辑器的集成： 许多富文本编辑器有自己的 API 来处理选区和内容操作，通常会封装原生的 Selection 和 Range API，并提供更高级别的抽象。在集成时，优先考虑使用编辑器提供的 API，以确保与编辑器内部状态的同步和兼容性。如果编辑器没有提供所需的功能，再考虑直接操作原生 API。
- 用户体验： 在执行替换操作后，通常需要清除当前的选区（selection.removeAllRanges()），以避免用户误以为选区仍然存在，影响后续操作。
- 安全性： 如果替换内容来自用户输入，务必进行适当的 HTML 转义或净化，以防止跨站脚本攻击（XSS）。
总结
通过熟练运用原生 JavaScript 的 Selection 和 Range API，开发者可以精确地控制和操作用户在 HTML 页面中选择的文本内容。无论是简单的文本替换、复杂的格式化，还是像示例中那样对选区进行标记和封装，这些 API 都提供了强大的底层支持。理解并掌握这些核心概念，是构建高性能、用户友好的富文本编辑功能和交互式 Web 应用的关键。
