本文旨在解决在使用 JavaScript 的 `range.surroundContents` 等方法处理跨多个 HTML 标签的文本选取时，由于 DOM 结构修改导致的选取范围错乱问题。通过提取选取内容，遍历子节点并重新构建 HTML，最终将修改后的 HTML 插回原位置，从而保持选取状态并实现预期的文本格式化效果。
在 Web 开发中，经常需要对用户选取的文本进行处理，例如添加样式、插入链接等。Selection 和 Range 对象提供了强大的文本选取和操作能力。然而，当选取的文本跨越多个 HTML 标签时，直接使用 range.surroundContents 等方法可能会导致问题，例如选取范围的改变，导致最终效果不符合预期。本文将探讨如何解决这类问题，并提供一种可行的解决方案。
问题描述
考虑以下 HTML 结构：
<p>This is a <strong>simple</strong> test</p>
如果用户选取了 "is a simple" 这部分文本，即选取从 p 标签的文本节点开始，到 strong 标签的文本节点结束。此时，如果直接使用 range.surroundContents 将选取的文本包裹在 <em> 标签中，可能会导致选取范围重置到 startContainer 的开始和结束位置，从而丢失了正确的选取范围。
解决方案
为了解决这个问题，可以采用以下步骤：
- 提取选取内容： 使用 activeRange.extractContents() 方法将选取的内容从 DOM 树中移除，并将其作为文档片段返回。
- 遍历子节点： 遍历文档片段的子节点，判断每个节点的类型，并根据需要进行处理。
- 构建新的 HTML： 根据遍历的结果，构建包含所需格式的新 HTML 字符串。
- 插入新的 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 if(node.nodeName == tagToUse)
rangeHTML += node.innerHTML;
else
rangeHTML += node.outerHTML;
});
rangeHTML += ']';
activeRange.insertNode(activeRange.createContextualFragment(rangeHTML));
});代码解释：
- activeRange.extractContents()：提取选取的全部内容，包括文本节点和 HTML 元素。
- rangeContents.childNodes.forEach()：遍历提取内容的子节点。
- node.nodeName == '#text'：判断节点是否为文本节点。如果是，则将其文本内容添加到 rangeHTML 中。
- node.nodeName == tagToUse：判断节点是否为需要特殊处理的标签，例如 <em>。如果是，则将其 innerHTML 添加到 rangeHTML 中。
- node.outerHTML：获取节点的完整 HTML 字符串，包括标签和内容。
- activeRange.insertNode()：将构建好的 HTML 字符串插入到 DOM 树中，替换原来的选取内容。
- activeRange.createContextualFragment(): 将 HTML 字符串转换为文档片段，以便插入到 DOM 树中。
完整示例：
<!DOCTYPE html>
<html>
<head>
<title>Selection Changes Example</title>
<style>
span{
padding: 0.5rem 1rem;
background: #CCC;
}
</style>
</head>
<body>
<p>This is a <strong>simple</strong> test</p>
<br>
<span id="get">Get selection</span>
<span id="replace">Replace Selection</span>
<script>
document.getElementById('get').addEventListener('mousedown', e => {
e.preventDefault();
const selection = window.getSelection(),
activeRange = selection.getRangeAt(0);
alert(activeRange.startContainer.textContent);
alert(activeRange.endContainer.textContent);
});
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; // Changed here to include the strong tag
});
rangeHTML += ']';
activeRange.insertNode(activeRange.createContextualFragment(rangeHTML));
});
</script>
</body>
</html>注意事项：
- 在实际应用中，需要根据具体的需求修改代码，例如添加对其他标签的处理逻辑。
- 需要考虑浏览器的兼容性问题，确保代码在不同的浏览器中都能正常运行。
- 如果需要对选取的文本进行更复杂的操作，可以考虑使用专业的 HTML 解析库，例如 DOMParser。
总结
本文提供了一种解决跨多标签字符串选取时范围改变问题的方案。通过提取选取内容，遍历子节点并重新构建 HTML，最终将修改后的 HTML 插回原位置，可以有效地保持选取状态并实现预期的文本格式化效果。这种方法可以应用于各种 Web 开发场景，例如富文本编辑器、在线文档处理等。通过理解和掌握这种方法，可以更好地处理文本选取和操作相关的任务。
