浏览器与 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。

完成高亮与复制
下面的完整页面只接受段落 #text 内的非空选区。点击工具栏不会清除选择;高亮操作先提取 Range 内容,再放入 mark 元素并插回原位置。复制操作读取同一 Range 的文本,在 HTTPS 或 localhost 环境中写入剪贴板。
<!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>预期结果
选中段落中的文本后,点击“高亮”,所选内容被 mark 元素包裹并保持选中。
点击“复制”,状态区显示“已复制:<选中的文本>”;环境不满足要求时显示权限提示。边界条件与安全处理
Range 会随 DOM 变化调整边界。执行 extractContents()、deleteContents() 或 insertNode() 后,原选区可能折叠或指向新的节点,所以需要重新创建可见 Range,并用 removeAllRanges() 与 addRange() 更新 Selection。
surroundContents() 只适合完整包含节点的范围;选区若部分跨过某个元素,它会抛出异常。复杂富文本编辑器还应限制可选区域、阻止跨块级节点包装,并在连续编辑后调用 normalize() 合并相邻文本节点。复制功能则要处理安全上下文、权限拒绝和空文本。