# 处理跨多标签的文本选区：避免文本范围错乱的解决方案

本文针对使用 javascript 处理跨多个 html 标签的文本选区时，可能出现的 `range.surroundcontents` 函数失效以及文本范围错乱问题，提供了一种解决方案。核心思路是提取选区内容，遍历子节点，构建新的 html 字符串，然后将新的 html 字符串插入到原来的位置，从而避免文本选区重置到起始容器的问题。

在使用 JavaScript 操作 DOM 时，`Range` 对象提供了一种方便的方式来选取和操作文档中的一部分内容。然而，当选区跨越多个 HTML 标签时，直接使用 `range.surroundContents` 等方法可能会遇到问题，导致选区范围的意外改变，甚至导致程序出错。本文将介绍一种处理此类问题的有效方法。 ### 问题描述 假设我们有如下 HTML 结构： ```html

This is a simple test

我们希望选中文本 "is a simple"，然后将其包裹在 标签中，期望的结果是：

This is a simple test

如果直接使用 range.surroundContents，可能会因为选区跨越 标签而导致问题。一种常见的错误做法是尝试修改 startContainer 和 endContainer 的 textContent，但这会导致文本选区重置到 startContainer 的起始位置。

解决方案：提取、遍历、重构

为了解决这个问题，我们可以采取以下步骤：

1. 提取选区内容： 使用 activeRange.extractContents() 方法将选区中的所有节点提取出来。
2. 遍历子节点： 遍历提取出的 rangeContents 的 childNodes 属性，即选区内的所有子节点。
3. 构建新的 HTML 字符串： 根据每个节点的类型（文本节点、元素节点等），构建新的 HTML 字符串。
4. 插入新的 HTML 字符串： 使用 activeRange.insertNode(activeRange.createContextualFragment(rangeHTML)) 将新的 HTML 字符串插入到原来的位置。

以下是一个示例代码：

document.getElementById('replace').addEventListener('mousedown', e => {
  e.preventDefault();

  const selection = window.getSelection(),
    activeRange = selection.getRangeAt(0);

  const rangeContents = activeRange.extractContents();

  let rangeHTML = ''; // 添加包裹标签
  rangeContents.childNodes.forEach(node => {
    if(node.nodeName == '#text')
      rangeHTML += node.textContent;
    else
      rangeHTML += node.outerHTML;
  });
  rangeHTML += ''; // 添加包裹标签
  activeRange.deleteContents(); //删除原来的内容
  activeRange.insertNode(activeRange.createContextualFragment(rangeHTML));
});

在这个例子中，我们首先提取选区内容，然后遍历每个节点。如果节点是文本节点，我们直接将其文本内容添加到 rangeHTML 字符串中；如果节点是元素节点，我们将其 outerHTML 添加到 rangeHTML 字符串中。最后，我们将 rangeHTML 字符串插入到原来的位置，并添加了 标签包裹选区。

代码解释：

• activeRange.extractContents(): 从文档中移除选区的内容，并返回一个 DocumentFragment 对象，包含被移除的内容。
• rangeContents.childNodes: 返回一个 NodeList，包含 DocumentFragment 中的所有子节点。
• node.nodeName: 返回节点的名称。文本节点的名称是 #text。
• node.textContent: 返回文本节点的内容。
• node.outerHTML: 返回元素节点的 HTML 代码，包括标签本身。
• activeRange.deleteContents(): 删除选区的内容。
• activeRange.insertNode(): 将一个节点插入到选区的起始位置。
• activeRange.createContextualFragment(): 将一个 HTML 字符串转换为一个 DocumentFragment 对象。

完整示例代码

  
  


  
This is a simple test
  

  Replace Selection

  

注意事项

• 在插入新的 HTML 字符串之前，务必删除原来的选区内容，避免重复。
• 在遍历子节点时，需要根据实际情况处理不同类型的节点，例如注释节点、属性节点等。
• 该方法适用于需要对选区内容进行复杂操作的场景，例如添加样式、修改属性等。
• 此方法会删除原来的选区，如果需要保留选区，需要手动设置。

总结

通过提取选区内容，遍历子节点，构建新的 HTML 字符串，然后将新的 HTML 字符串插入到原来的位置，我们可以有效地解决跨多标签的文本选区处理问题，避免文本范围错乱，并实现更灵活的 DOM 操作。该方法的核心在于精确控制每个节点的处理方式，从而确保最终结果的正确性。