不能用 innerHTML.replace() 直接高亮,因其将HTML当纯字符串处理,必然撕裂标签结构、触发XSS、清空表单值、丢失事件监听器、切分中文词且无法区分语义;必须只操作文本节点,用TreeWalker遍历、关键词转义、mark包裹并normalize。

为什么不能用 innerHTML.replace() 直接高亮
它把整个 HTML 字符串当纯文本处理,一搜就撕开标签:比如原文是 <p>error: 404</p>,正则匹配 error 后插入 <mark>error</mark>,结果变成 <p><mark>error</mark>: 404</p>——看似 OK,但若关键词含 " 或 ,就会生成非法结构;更危险的是,用户输入含 <code><script>alert(1)</script>,赋值 innerHTML 瞬间执行。
还会清空表单值、丢失事件监听器、让中文词(如“用户名错误”)被切在中间,且无法区分真实语义——正文里出现的 [3] 和参考文献里的 [3] 全被标红。
- 永远用
textContent提取原始文本,不用innerText(会吞掉隐藏内容) - 关键词含
.、?、[等时,必须先转义:keyword.replace(/[.*+?^${}()|[]]/g, '\$&') - 匹配后必须调用
node.parentNode.normalize(),否则下次高亮同一段文字会嵌套<mark><mark>xxx</mark></mark>
必须遍历文本节点(NodeFilter.SHOW_TEXT)
这是唯一能绕过所有 HTML 标签、只操作人类可读文字的安全路径。不走这条路,就等于主动放弃 DOM 安全和 XSS 防护。
立即学习“前端免费学习笔记(深入)”;
用 document.createTreeWalker(element, NodeFilter.SHOW_TEXT) 创建遍历器,它天然跳过 SCRIPT、STYLE、TEXTAREA 和所有元素节点。
- 循环中加守卫:
if (!node.textContent.trim() || node.parentElement?.tagName === 'SCRIPT' || node.parentElement?.tagName === 'TEXTAREA') continue - 对每个有效节点,用
node.nodeValue(不是textContent)做正则匹配和替换,因为nodeValue可写 - 创建
mark元素:const mark = document.createElement('mark'); mark.textContent = match;,再用node.parentNode.replaceChild(mark, node) - 替换完立刻
node.parentNode.normalize(),合并相邻文本节点,防止断裂高亮
多关键词高亮必须按长度降序排序
同时高亮 JavaScript 和 Script 时,如果先匹配短词,会得到 <mark>Java</mark><mark>Script</mark>,表面看是两个独立 mark,但浏览器自动修正后语义已断裂——屏幕阅读器无法感知“JavaScript”是一个完整术语,CSS 圆角/内边距也会叠加错乱。
- 排序必须写死:
keywords.sort((a, b) => b.length - a.length) - 中文混合场景下,用
Intl.Collator().compare()更稳妥,避免字节序错乱 - 服务端渲染页面,前端再次高亮前,先清除已有
mark:element.querySelectorAll('mark').forEach(el => el.replaceWith(el.textContent)) - 别信“一次遍历全搞定”的封装函数——每轮关键词都要重新遍历文本节点,否则漏匹配
深色模式与可访问性不是附加项,是必需配置
mark 在 Windows 高对比度模式下默认背景会被清空,在 Outlook 邮件里直接不可见,项目用了 * { background: transparent } 也会让它彻底消失。
必须显式声明样式:
mark {
background-color: #fff9c4;
color: #1f2937;
padding: 2px 4px;
border-radius: 3px;
}
@media (prefers-color-scheme: dark) {
mark {
background-color: #ffcc00;
color: #111;
}
}WCAG 要求文字对比度 ≥ 4.5:1,#ffcc00 在白底上仅 1.4:1,必须换色或加 text-shadow 补足可读性。没有 ARIA 属性的 mark 对屏幕阅读器只是透明装饰——若需语义强化,可加 aria-label="高亮匹配内容",但优先确保颜色对比达标。



















