标签实现稳定、精准的文本高亮功能
" />
本文介绍一种基于语义化 HTML <mark> 标签的纯前端文本高亮方案，替代易出错的正则替换逻辑，解决多句高亮失效、重复字符误匹配等常见 Bug，确保用户拖选任意长度文本（含空格、标点、换行）均能准确高亮且可逆清除。
本文介绍一种基于语义化 html `` 标签的纯前端文本高亮方案，替代易出错的正则替换逻辑，解决多句高亮失效、重复字符误匹配等常见 bug，确保用户拖选任意长度文本（含空格、标点、换行）均能准确高亮且可逆清除。
传统基于 innerHTML + 正则替换的高亮方式（如原代码中用 new RegExp(selectedText, 'g')）存在根本性缺陷：
- ✅ 语义丢失：直接操作 HTML 字符串破坏 DOM 结构，导致嵌套标签、实体编码（如 ）、前后空白处理异常；
- ❌ 全局误匹配：正则 /abc/g 会匹配所有独立出现的 "abc" 子串，而非用户实际选中的连续文本节点片段，造成“单字母高亮 → 全文同字母被染黄”的 Bug；
- ❌ 范围失控：无法区分不同 DOM 节点中的相同文本，也无法保留原始文本位置信息，导致跨句子、跨段落高亮失败。
✅ 正确解法：使用 <mark> + Range API 精准包裹选区
现代浏览器支持通过 window.getSelection() 获取真实选区（Range 对象），再用 document.createElement('mark') 将其原位包裹，完全避免字符串替换风险：
<!DOCTYPE html>
<html lang="en">
<head>
<style>
#content { line-height: 1.6; padding: 20px; max-width: 800px; margin: 0 auto; }
#removeHighlight { margin: 20px 20px 0; padding: 8px 16px; background: #4CAF50; color: white; border: none; border-radius: 4px; cursor: pointer; }
#removeHighlight:hover { background: #45a049; }
mark { background-color: #ffeb3b; padding: 2px 4px; border-radius: 3px; }
</style>
</head>
<body>
<div id="content">
Lorem ipsum dolor sit amet, cu eum eros vitae persequeris, laudem possit nam ex. Labore eloquentiam per an. Sit ex omnesque interpretaris, habeo tantas eos ad, ea eos ludus inciderint. Facete tritani pro ei, vim evertitur liberavisse ex. Ridens indoctum
duo cu, est utamur aliquando expetendis ne. Cum nusquam definiebas ex, id esse neglegentur cum, eu libris bonorum volumus vis. Ius et quis omnis graeco, no his nullam perpetua dissentiet. No vix possim scripserit consequuntur, te mnesarchum philosophia
sed. Ne mea putent iudicabit, in eam ipsum viris dicunt. Eum amet accommodare ex, sint malis adversarium at qui.
</div>
<button id="removeHighlight">Clear All Highlights</button>
<script>
const contentDiv = document.getElementById('content');
const clearBtn = document.getElementById('removeHighlight');
// 高亮当前选中文本（精确到 Range）
function highlightSelection() {
const selection = window.getSelection();
if (!selection.rangeCount || selection.toString().trim() === '') return;
// 遍历每个 Range（支持多区域选中）
for (let i = 0; i < selection.rangeCount; i++) {
const range = selection.getRangeAt(i);
// 只对内容区域内的选区操作
if (!contentDiv.contains(range.commonAncestorContainer)) continue;
const mark = document.createElement('mark');
range.surroundContents(mark); // 精准包裹，不破坏结构
}
}
// 清除所有 <mark> 标签，还原纯文本内容
function clearHighlights() {
const marks = contentDiv.querySelectorAll('mark');
marks.forEach(mark => {
// 将 mark 内容移出并替换父节点中的 mark
const parent = mark.parentNode;
const fragment = document.createDocumentFragment();
while (mark.firstChild) {
fragment.appendChild(mark.firstChild);
}
parent.replaceChild(fragment, mark);
});
}
// 绑定事件：鼠标释放时高亮（避免 keyup 干扰）
document.addEventListener('mouseup', highlightSelection);
// 清除按钮点击事件
clearBtn.addEventListener('click', clearHighlights);
</script>
</body>
</html>⚠️ 关键注意事项
- 不要监听 keyup：原代码中 onkeyup 触发无意义高亮（用户未选中文本），且可能在输入法状态下触发异常；仅需 mouseup 即可覆盖所有鼠标拖选场景。
- surroundContents() 的前提：要求 Range 必须完全位于单一 TextNode 内。若选区跨越多个节点（如跨 <p> 或含 <br>），需先调用 range.cloneContents() + 手动拆分包裹（进阶需求可引入 Rangy 库处理）。本例中因内容为纯文本段落，天然满足条件。
- 样式可定制：<mark> 默认浏览器样式为黄色背景，可通过 CSS 覆盖（如上例中自定义 padding 和 border-radius）。
- 无障碍友好：<mark> 是 WAI-ARIA 推荐的语义化高亮元素，屏幕阅读器可识别其强调作用。
✅ 总结
用 <mark> 替代正则替换，本质是从“字符串操作”回归“DOM 操作”——利用浏览器原生 Selection/Range API 精确控制高亮边界，彻底规避文本歧义匹配问题。该方案轻量、可靠、语义正确，适用于任何需要用户交互式高亮的场景（如阅读辅助、文档标注、协作批注等）。
