JavaScript Range 对象：跨越多个标签的文本选区处理-js教程-PHP中文网

JavaScript Range 对象：跨越多个标签的文本选区处理

聖光之護

发布： 2025-10-19 13:25:30

原创

854人浏览过

javascript range 对象：跨越多个标签的文本选区处理

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

问题描述

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

<p>This is a <strong>simple</strong> test</p>

登录后复制

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

立即学习“Java免费学习笔记（深入）”；

<p>This <em>is a </em><strong><em>simple</em></strong> test</p>

登录后复制

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

Seed-TTS

Seed-TTS 是一个高质量多功能的文本到语音生成模型

909

查看详情

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

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

提取选区内容： 使用 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 = '<em>';
  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 += '</em>';
  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




<p>This is a <strong>simple</strong> test</p>


Get selection
Replace Selection

<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 = '<em>';
  rangeContents.childNodes.forEach(node => {
    if (node.nodeName == '#text')
      rangeHTML += node.textContent;
    else if (node.nodeName == 'STRONG')
      rangeHTML += node.outerHTML;
    else
      rangeHTML += node.outerHTML;
  });
  rangeHTML += '</em>';
  activeRange.deleteContents();
  activeRange.insertNode(activeRange.createContextualFragment(rangeHTML));
});
</script>

登录后复制

使用方法：