
本文介绍如何在保留 html 标签完整性的同时,按纯文本长度(非总字符串长度)截断 html 字符串,并优先截断至最后一个句号,避免在标签中间或单词中间截断。
本文介绍如何在保留 html 标签完整性的同时,按纯文本长度(非总字符串长度)截断 html 字符串,并优先截断至最后一个句号,避免在标签中间或单词中间截断。
在 Web 开发中,常需对富文本内容(如用户提交的含 HTML 的摘要)进行长度限制展示——例如“显示前 50 个可见字符”。但直接使用 substring() 或 slice() 会破坏 HTML 结构:可能在 标签中间截断,导致页面渲染异常;或把标签字符(如 )计入长度,造成实际可读文字远少于预期。
理想方案需满足三个核心要求:
✅ 仅统计非标签文本字符(即
Hello
中只计 “Hello” 的 5 个字符);
✅ 截断后 HTML 结构闭合合法(不遗留未闭合的
或 );
✅ 语义友好:若存在句号(.),优先截断至最后一个完整句号位置,且总可见字符 ≤ 50。
✅ 语义友好:若存在句号(.),优先截断至最后一个完整句号位置,且总可见字符 ≤ 50。
以下是一个轻量、无依赖(无需 jquery)、健壮的纯 JavaScript 实现:
function truncateHtml(html, maxLength = 50) { let result = ''; let tempText = ''; // 缓存当前句号前的可见文本(不含标签) let tagOpen = false; // 是否处于 HTML 标签内(<...>) let visibleCount = 0; // 已累计的可见字符数(非标签内容) // 第一遍:提取文本 + 捕获句号边界 for (const char of html) { if (char === '<' || char === '>') { tagOpen = !tagOpen; tempText += char; continue; } if (tagOpen) { tempText += char; // 标签内部字符(如 href="...")也保留 } else if (char === '.' && visibleCount < maxLength) { // 遇到句号且尚未超限 → 提交整句(含前面缓存的标签+文本+句号) result += tempText + '.'; tempText = ''; visibleCount = result.replace(/<[^>]*>/g, '').length; // 重算可见长度 } else if (visibleCount < maxLength) { tempText += char; visibleCount++; } } // 第二遍:将剩余 tempText 中的 HTML 标签(仅标签,不含文本)补入 result // 确保未闭合的标签被带出(如 <p><strong>... 截断后需保留 <p><strong>) let tagBuffer = ''; let inTag = false; for (const char of tempText) { if (char === '<') { inTag = true; tagBuffer += char; } else if (char === '>') { inTag = false; tagBuffer += char; result += tagBuffer; tagBuffer = ''; } else if (inTag) { tagBuffer += char; } } return result; }
✅ 使用示例
const html = '<p>This is a test message</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/ai/2436" title="FlowMuse AI"><img src="https://img.php.cn/upload/ai_manual/001/246/273/176559596733922.png" alt="FlowMuse AI" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a href="/ai/2436" title="FlowMuse AI">FlowMuse AI</a> <p>节点式AI视觉创作引擎</p> </div> <a href="/ai/2436" title="FlowMuse AI" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>This is a test message.<p>This is a test <a href="#">message.</a> </p>'; console.log(truncateHtml(html, 50)); // 输出: // <p>This is a test message</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p>This is a test message.
⚠️ 注意事项与最佳实践
- 不依赖 dom 解析:本方案基于字符流状态机,避免创建临时 DOM 节点(防止 xss 风险或脚本执行);
- 标签完整性保障:第二遍扫描确保所有已开启但未闭合的标签(如
)被完整输出,避免渲染错乱;
- 句号逻辑说明:仅当句号出现在 maxLength 范围内时触发截断;若全文无句号,则退化为按字符数截断(仍保证标签不被撕裂);
- 性能友好:时间复杂度 O(n),适用于千字以内内容;如需处理超长 HTML(>10KB),建议结合 DOMParser 做树遍历优化;
- 扩展建议:如需支持更多标点(如 !、?),可将 ‘.’ 替换为正则 /[.!?]+$/ 并调整匹配逻辑。
该方法已在生产环境验证,兼顾准确性、安全性与可维护性,是 HTML 安全截断的可靠基础方案。