本文档旨在解决使用 JavaScript `Range` 对象处理跨越多个 HTML 标签的文本选区时遇到的问题，重点在于避免在修改选区内容后导致文本选区重置。通过提取选区内容，遍历节点并重新构建 HTML，可以有效地解决此问题，并提供示例代码进行演示。
问题描述
在使用 JavaScript 的 Range 对象进行文本操作时，如果选区跨越了多个 HTML 标签，直接使用 range.surroundContents 或类似的修改方法可能会导致选区发生改变，例如重置到 startContainer 的起始位置。考虑以下 HTML 结构：
This is a simple test
如果用户选中的文本是 "is a simple"，目标是将其设置为斜体，期望的结果是：
立即学习“Java免费学习笔记（深入）”；
This is a simple test
直接修改 startContainer 和 endContainer 的内容可能会导致选区丢失或不正确。
解决方案：提取、修改、重构
解决此问题的核心思路是：
- 提取选区内容： 使用 range.extractContents() 方法将选区中的所有节点提取出来。
- 遍历和修改节点： 遍历提取出的节点，根据需要修改每个节点的内容或属性。
- 重构 HTML： 将修改后的节点重新组合成 HTML 字符串。
- 插入新内容： 使用 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 对象，并将其插入到选区的位置。
完整示例
Range Example This is a simple test
Get selection Replace Selection
使用方法：
- 复制以上代码到 HTML 文件中。
- 在浏览器中打开该 HTML 文件。
- 选择 "is a simple" 这段文本。
- 点击 "Replace Selection" 按钮。
- 查看结果，选中的文本已经被 标签包裹。
注意事项
- tagToUse 变量： 在实际应用中，需要根据具体需求定义 tagToUse 变量，以指定要使用的 HTML 标签。
- 错误处理： 在处理 childNodes 时，应考虑可能出现的其他节点类型，并进行相应的处理，例如注释节点、属性节点等。
- 性能： 对于大型文档或复杂的选区，此方法可能会影响性能。可以考虑使用更高效的算法或库来优化性能。
- 选区删除: 在插入新内容之前，需要使用 activeRange.deleteContents() 删除选区内的原有内容，否则会导致重复内容。
总结
通过提取选区内容，遍历节点并重新构建 HTML，可以有效地解决 JavaScript Range 对象在处理跨越多个标签的文本选区时遇到的问题。这种方法可以确保选区在修改后不会发生改变，并提供了一种灵活的方式来操作和修改选区中的内容。 记住，要根据实际需求调整代码，并注意性能和错误处理。
