浏览器与 Web API / 系统课时

Range 与 Selection 文本范围

Range 与 Selection 文本范围

Range 用边界点描述 DOM 中的一段内容,Selection 则表示用户当前选中的范围。本课将把两者组合起来,完成选区校验、文本高亮和剪贴板复制,并处理空选区、跨容器选区与 DOM 修改后的范围变化。

学习目标

  • 说明 Range 与 Selection 的职责差异及配合方式。
  • 获取并校验当前文本选区,避免处理页面其他区域。
  • 使用同一份选区完成高亮和复制,并识别常见边界。

Range 与 Selection 如何配合

Range 保存起点容器、起点偏移、终点容器和终点偏移,因此它描述的是 DOM 边界,而不是一段独立字符串。Selection 由 window.getSelection() 返回,负责保存用户当前选区;浏览器中的普通文本选择通常包含一个 Range。

读取选区时先检查 rangeCount 和 isCollapsed。随后通过 getRangeAt(0) 取得范围,再验证 commonAncestorContainer 是否位于目标容器中。业务代码最好使用 cloneRange() 保存副本,避免直接修改浏览器正在维护的 Range。

Range 与 Selection 获取、校验和处理流程

完成高亮与复制

下面的完整页面只接受段落 #text 内的非空选区。点击工具栏不会清除选择;高亮操作先提取 Range 内容,再放入 mark 元素并插回原位置。复制操作读取同一 Range 的文本,在 HTTPS 或 localhost 环境中写入剪贴板。

html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Range 与 Selection 示例</title>
<style>
body { font: 16px/1.7 sans-serif; max-width: 720px; margin: 40px auto; }
#toolbar { display: flex; gap: 8px; }
mark { background: #ffe08a; }
#state { color: #345; }
</style>
</head>
<body>
<div id="toolbar">
<button id="highlight">高亮</button>
<button id="copy">复制</button>
</div>
<p id="text">请拖动鼠标选中这段文字中的一部分,然后执行高亮或复制操作。</p>
<p id="state">请先选择段落中的文本。</p>
<script>
const text = document.querySelector("#text");
const toolbar = document.querySelector("#toolbar");
const state = document.querySelector("#state");
toolbar.addEventListener("mousedown", event => event.preventDefault());
function cloneSelectedRange() {
  const selection = window.getSelection();
  if (!selection || selection.rangeCount === 0 || selection.isCollapsed) return null;
  const range = selection.getRangeAt(0);
  if (!text.contains(range.commonAncestorContainer)) return null;
  return range.cloneRange();
}
document.querySelector("#highlight").addEventListener("click", () => {
  const range = cloneSelectedRange();
  if (!range) {
    state.textContent = "请选择段落内部的非空文本。";
    return;
  }
  const mark = document.createElement("mark");
  mark.append(range.extractContents());
  range.insertNode(mark);
  const selection = window.getSelection();
  const visibleRange = document.createRange();
  visibleRange.selectNodeContents(mark);
  selection.removeAllRanges();
  selection.addRange(visibleRange);
  state.textContent = `已高亮:${selection.toString()}`;
});
document.querySelector("#copy").addEventListener("click", async () => {
  const range = cloneSelectedRange();
  if (!range) {
    state.textContent = "请选择段落内部的非空文本。";
    return;
  }
  try {
    await navigator.clipboard.writeText(range.toString());
    state.textContent = `已复制:${range.toString()}`;
  } catch {
    state.textContent = "复制失败,请使用 HTTPS 或 localhost 并允许剪贴板权限。";
  }
});
</script>
</body>
</html>

预期结果

text
选中段落中的文本后,点击“高亮”,所选内容被 mark 元素包裹并保持选中。
点击“复制”,状态区显示“已复制:<选中的文本>”;环境不满足要求时显示权限提示。

边界条件与安全处理

Range 会随 DOM 变化调整边界。执行 extractContents()、deleteContents() 或 insertNode() 后,原选区可能折叠或指向新的节点,所以需要重新创建可见 Range,并用 removeAllRanges() 与 addRange() 更新 Selection。

surroundContents() 只适合完整包含节点的范围;选区若部分跨过某个元素,它会抛出异常。复杂富文本编辑器还应限制可选区域、阻止跨块级节点包装,并在连续编辑后调用 normalize() 合并相邻文本节点。复制功能则要处理安全上下文、权限拒绝和空文本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Range 与 Selection 文本范围

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通