17370845950

本文档旨在解决使用 JavaScript `Range` 对象处理跨越多个 HTML 标签的文本选区时遇到的问题，重点在于避免在修改选区内容后导致文本选区重置。通过提取选区内容，遍历节点并重新构建 HTML，可以有效地解决此问题，并提供示例代码进行演示。

问题描述

在使用 JavaScript 的 Range 对象进行文本操作时，如果选区跨越了多个 HTML 标签，直接使用 range.surroundContents 或类似的修改方法可能会导致选区发生改变，例如重置到 startContainer 的起始位置。考虑以下 HTML 结构：

This is a simple test

如果用户选中的文本是 "is a simple"，目标是将其设置为斜体，期望的结果是：

This is a simple test

直接修改 startContainer 和 endContainer 的内容可能会导致选区丢失或不正确。

解决方案：提取、修改、重构

解决此问题的核心思路是：

1. 提取选区内容： 使用 range.extractContents() 方法将选区中的所有节点提取出来。
2. 遍历和修改节点： 遍历提取出的节点，根据需要修改每个节点的内容或属性。
3. 重构 HTML： 将修改后的节点重新组合成 HTML 字符串。
4. 插入新内容： 使用 range.insertNode() 方法将新的 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 if (node.nodeName == 'STRONG') // 示例：保留 strong 标签
      rangeHTML += node.outerHTML;
    else
      rangeHTML += node.outerHTML;
  });
  rangeHTML += '';
  activeRange.deleteContents(); // 删除原有内容
  activeRange.insertNode(activeRange.createContextualFragment(rangeHTML));
});

代码解释：

• activeRange.extractContents(): 提取选区内的所有节点，返回一个 DocumentFragment 对象。
• rangeContents.childNodes.forEach(): 遍历 DocumentFragment 中的每个子节点。
• node.nodeName == '#text': 检查节点是否为文本节点。如果是，则直接将其文本内容添加到 rangeHTML 中。
• node.nodeName == 'STRONG': 检查节点是否为 标签。如果是，则保留原有标签，直接将其 outerHTML 添加到 rangeHTML 中。
• rangeHTML += node.outerHTML: 对于其他类型的节点，将其 outerHTML 添加到 rangeHTML 中。
• activeRange.deleteContents(): 删除选区内的原有内容，避免重复。
• activeRange.insertNode(activeRange.createContextualFragment(rangeHTML)): 将新的 HTML 字符串转换为 DocumentFragment 对象，并将其插入到选区的位置。

完整示例

This is a simple test


Get selection
Replace Selection

使用方法：

1. 复制以上代码到 HTML 文件中。
2. 在浏览器中打开该 HTML 文件。
3. 选择 "is a simple" 这段文本。
4. 点击 "Replace Selection" 按钮。
5. 查看结果，选中的文本已经被 标签包裹。

注意事项

• tagToUse 变量： 在实际应用中，需要根据具体需求定义 tagToUse 变量，以指定要使用的 HTML 标签。
• 错误处理： 在处理 childNodes 时，应考虑可能出现的其他节点类型，并进行相应的处理，例如注释节点、属性节点等。
• 性能： 对于大型文档或复杂的选区，此方法可能会影响性能。可以考虑使用更高效的算法或库来优化性能。
• 选区删除: 在插入新内容之前，需要使用 activeRange.deleteContents() 删除选区内的原有内容，否则会导致重复内容。

总结

通过提取选区内容，遍历节点并重新构建 HTML，可以有效地解决 JavaScript Range 对象在处理跨越多个标签的文本选区时遇到的问题。这种方法可以确保选区在修改后不会发生改变，并提供了一种灵活的方式来操作和修改选区中的内容。 记住，要根据实际需求调整代码，并注意性能和错误处理。