
本文介绍一种健壮的 javascript 方式:先彻底剥离 html 标签,再对纯文本进行多关键词正则高亮,并避免重复替换、转义问题及性能隐患。
本文介绍一种健壮的 javascript 方式:先彻底剥离 html 标签,再对纯文本进行多关键词正则高亮,并避免重复替换、转义问题及性能隐患。
在实际开发中(如搜索摘要预览或富文本高亮),我们常需对含 HTML 的原始内容做两步处理:先净化为纯文本,再高亮用户输入的关键词。但原代码存在多个关键缺陷:
- 三次重复执行
data.replace(/]*>?/gi, ""),低效且易出错; - 使用
String.raw错误拼接正则字面量(String.raw不用于包裹/.../,而是用于构造无转义字符串); - 未对
query做正则特殊字符转义,若搜索词含.、*、(等,将导致匹配失败或异常; - 单次替换仅处理首个匹配项(
replace()默认只替换第一个),无法实现全文高亮; - 截断逻辑(
slice(0, 400))在高亮前执行,导致高亮标签被截断或丢失。
以下是优化后的专业实现:
// 安全移除 HTML 标签(比正则更可靠,防 XSS)
function stripHtml(html) {
const tmp = document.createElement('div');
tmp.innerHTML = html;
return tmp.textContent || tmp.innerText || '';
}
// 对正则特殊字符进行转义,确保 query 可安全用于 RegExp
function escapeRegExp(string) {
return string.replace(/[.*+?^${}()|[]\]/g, '\$&'); // $& 表示整个匹配项
}
// 主高亮函数:支持多关键词、自动转义、全文替换、长度控制
function highlightKeywords(text, keywords, maxLength = 400, className = 'highlight') {
if (!text || !keywords?.length) return text || '';
// 步骤1:安全剥离 HTML
let cleanText = stripHtml(text);
// 步骤2:逐个高亮关键词(注意:按顺序处理,避免嵌套干扰)
keywords.forEach(keyword => {
if (!keyword.trim()) return;
const escapedKeyword = escapeRegExp(keyword.trim());
const regex = new RegExp(escapedKeyword, 'gi');
cleanText = cleanText.replace(regex, `<span class="${className}">$&</span>`);
});
// 步骤3:截断(在高亮后进行,确保标签完整)
if (cleanText.length > maxLength) {
// 尝试在最后一个空格处截断,避免单词断裂
const truncated = cleanText.slice(0, maxLength);
const lastSpace = truncated.lastIndexOf(' ');
cleanText = lastSpace > 0
? truncated.slice(0, lastSpace) + '...'
: truncated.slice(0, maxLength - 3) + '...';
}
return cleanText;
}
// 使用示例
const article = "<p>The <strong>quick</strong> brown fox jumps over the lazy <em>dog</em>.</p>";
const searchTags = ['fox', 'dog', 'quick'];
const result = highlightKeywords(article, searchTags, 300, 'highlight');
// 输出:<span class="highlight">quick</span> brown <span class="highlight">fox</span> jumps over the lazy <span class="highlight">dog</span>...⚠️ 重要注意事项:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
-
永远不要用正则解析 HTML:
/]*>?/gi在复杂嵌套(如<script></script>、注释、CDATA)下极易失效甚至引入 XSS 风险。stripHtml()利用浏览器原生 DOM 解析器,安全可靠; -
必须转义关键词:
escapeRegExp()是必备步骤,否则搜索a.b*c会被解释为正则模式而非字面量; -
避免
className拼接 XSS:示例中className来自受信源;若动态传入,需额外校验(如白名单); -
React 中慎用
dangerouslySetInnerHTML:若在 React 组件中使用,需确保返回内容已通过DOMPurify.sanitize()等库净化,或改用textContent+ CSS 高亮方案。
最终,在 JSX 中安全调用:
<p
className="paragraph--s"
dangerouslySetInnerHTML={{ __html: format(searchTag, article) }}
/>其中 format 应封装为 highlightKeywords 的单关键词快捷调用。


















