必须用 Range + Selection API 实现动态高亮,因正则替换会破坏 DOM 结构、无法准确定位跨元素/换行/空格文本,导致选区丢失、HTML 非法、高亮失效;surroundContents() 需校验节点、克隆 Range、容错降级;中文标点需 trim 和转义正则;mark 标签须语义正确、样式重置、适配暗色模式与可访问性。

必须用 Range + Selection API 做动态高亮,不能靠正则替换文本节点——否则选区一触发就消失,跨元素、含换行、带空格的文本根本包不准。
为什么不能用正则替换实现“选中即高亮”
用户手动拖选一段文字后,getSelection() 返回的是真实 DOM 位置(Range 对象),而正则只在字符串里瞎找。常见崩坏现象:
- 选中
React Native中的 “React Native”,正则切开标签,生成非法 HTML - 选区跨两个
段落,正则只能匹配单个文本节点,漏掉一半 - 选中内容含换行或全角空格,
textContent已归一化,起始偏移对不上 - 高亮后原
Range失效,getSelection().rangeCount === 0,光标凭空消失
用 surroundContents() 包裹选区的实操要点
这是最直接对应“选中即高亮”的原生路径,但极易报错,关键在前置校验和容错处理:
- 必须先调用
range.cloneRange(),防止高亮过程中 Range 被自动清除 - 执行前检查
range.intersectsNode(node),跳过SCRIPT、STYLE、TEXTAREA等禁止操作的父节点 -
surroundContents()要求 Range 必须完全落在一个 Text 节点内;若选区跨节点,得先用range.extractContents()拿出片段,再逐段包裹 - 包裹失败时(比如 Range 被破坏),降级为创建新
mark元素并insertAdjacentElement('afterend')插入
中文与标点场景下的边界处理
用户常选中“服务。”(带句号)或“#tag-123”,但默认 Range 不识别词义。需主动约束高亮范围:
- 用
range.toString().trim()获取纯文本内容,过滤首尾空白和不可见字符 - 对关键词做正则转义:
keyword.replace(/[.*+?^${}()|[]]/g, '\$&'),避免a.b被当正则匹配 - 若需防“服务器”误匹配“服务”,不推荐在
Range阶段加 Unicode 边界断言——它和 DOM 位置无关;应在高亮后用 CSSmark { background-color: #fff9c4; }配合@media (prefers-color-scheme: dark)强制覆盖,默认黄底在深色模式下根本看不见
高亮后保持可编辑性与可访问性
mark 是唯一语义正确的标签,但浏览器默认样式在 IE 和旧 Safari 上失效,且子元素颜色会被继承污染:
- 必须显式重置
mark > *的color和background-color,例如:mark > strong { color: inherit; background: transparent; } - 盲人用户依赖读屏器播报
mark,所以绝不能用span.highlight替代;也别嵌套mark,否则读屏器会重复读“高亮文本 高亮文本” - 高亮后表单值、事件监听器不会丢失,但若原选区在
contenteditable区域,需在高亮后调用range.collapse(false)把光标移到末尾,否则用户继续打字会插在错误位置
真正难的不是怎么高亮,而是怎么让高亮不破坏原有交互流——选区位置、焦点状态、读屏节奏、暗色模式适配,每个环节都可能断链。别省那几行代码,该 clone 的 range 一定要 clone,该 normalize 的父节点一定要 normalize。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











