不能用 innerHTML.replace() 做搜索高亮,因其将HTML当纯文本处理,导致XSS、DOM结构崩坏、图片/脚本失效、暗色模式不可见等确定性故障,且遇&、.、正则元字符等必报错。

直接用 innerHTML.replace() 做搜索高亮,90% 以上概率会出事:XSS、DOM 结构崩坏、图片/脚本失效、暗色模式下完全不可见——这不是小概率事件,而是输入一含 & 或 . 就触发的确定性故障。
为什么不能用 innerHTML.replace() 动态插入 mark
这是最常被抄来就用、也最容易在线上翻车的写法。它把整个 HTML 字符串当纯文本处理,而忽略里面混着标签、属性、事件监听器和用户输入状态。
- 用户搜
<script>alert(1)</script>→ 拼进字符串后可能直接执行脚本 - 原文是
,搜
logo→ 变成,图片加载失败
- 关键词含正则元字符(如
cat[0]、a.b)→new RegExp(keyword)报SyntaxError,脚本中断 - 关键词含
&、"、→ 替换后 HTML 实体错乱,后续标签解析失败,页面白屏 - 表单里用户已填的内容、按钮绑定的
onclick、动态插入的组件节点,全被innerHTML = ...覆盖清空
安全高亮必须只操作文本节点(NodeFilter.SHOW_TEXT)
核心逻辑是:绕过字符串拼接,只让正则匹配人类可读的纯文本内容,并用 DOM 方法原地替换节点。
- 用
document.createTreeWalker(element, NodeFilter.SHOW_TEXT, null, false)获取所有文本节点 - 循环中跳过空或仅空白符节点:
if (!node.textContent.trim()) continue - 关键词先 HTML 转义:
keyword.replace(/[&"'`=/]/g, c => `${c.charCodeAt(0)};`) - 再正则转义:
keyword.replace(/[.*+?^${}()|[]]/g, '\$&') - 构造正则:
new RegExp(`(${escapedKeyword})`, 'gi') - 匹配后不用字符串拼接,而是:
const mark = document.createElement('mark'); mark.textContent = matchedText; node.parentNode.replaceChild(mark, node); - 每次替换后调用
node.parentNode.normalize(),合并相邻文本节点,防止重复高亮
mark 样式必须显式声明,浏览器默认值不能交付
默认黄色背景在真实环境中基本等于“不显示”:Safari 阅读模式剥离 UA 样式、Windows 高对比度强制重置、深色主题下对比度低于 WCAG AA、Outlook 等邮件客户端直接无视。
- 至少写死这三项:
background-color、color、padding - 别用
background: none—— 它不清除background-image,应写background-color: transparent - 深色模式适配必须手动加:
@media (prefers-color-scheme: dark) { mark { background-color: #ffca28; color: #121212; } } - 中文搜索若需防误匹配(如搜“服务”不希望高亮“服务器”),可用 Unicode 边界断言:
/(?
框架中别滥用 dangerouslySetInnerHTML 或 v-html
React/Vue 项目里直接插渲染后的 HTML 字符串,等于放弃语义、可访问性和 XSS 防御能力。框架本身提供了更安全的路径。
- React:用
useEffect+ref获取容器 DOM,走 TreeWalker 方案;或封装为自定义 Hook,传入关键词和容器 ref - Vue:用
mounted钩子 +template ref,避免在v-html里拼接用户输入 - 所有方案都必须提前对
keyword做 HTML 和正则双重转义,且限定高亮范围(如只处理.article-content,跳过header、nav) - 如果必须用第三方库(如
mark.js),务必配置element: 'mark'、separateWordSearch: false(中文场景)、caseSensitive: false,并手动传入转义后的 keyword
真正麻烦的不是怎么写高亮,而是怎么确保它不破坏已有结构、不引入 XSS、不在暗色模式里消失、不把用户的表单输入清空——这些点漏掉任意一个,上线后就是生产事故。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











