
本文提供一种不依赖jQuery的纯JavaScript方案,用于安全截断含HTML标签的字符串:仅统计可见文本长度(忽略标签),支持在不超过指定字符数的前提下,优先截断到最近的句号(.),同时保持HTML标签闭合完整性。
本文提供一种不依赖jquery的纯javascript方案,用于安全截断含html标签的字符串:仅统计可见文本长度(忽略标签),支持在不超过指定字符数的前提下,优先截断到最近的句号(`.`),同时保持html标签闭合完整性。
在Web开发中,常需对富文本片段(如用户评论、文章摘要)进行长度限制展示,但直接按字符串长度截断极易破坏HTML结构——例如在标签中间切断,导致页面渲染异常或XSS风险;若先用textContent提取纯文本再截断,则完全丢失原有格式。理想方案应满足三个核心要求:
- 语义感知:仅将非标签内容(即用户可见文本)计入长度统计;
- 语法友好:优先停在标点(如句号 .)处,提升可读性;
- 结构安全:确保返回结果中所有HTML标签成对闭合,避免DOM解析错误。
以下函数 truncateHtmlString 完全满足上述需求,采用单次遍历+状态机策略,时间复杂度 O(n),无正则回溯风险,兼容任意嵌套标签:
/**
* 安全截断含HTML的字符串
* @param {string} html - 原始HTML字符串
* @param {number} maxLength - 最大可见字符数(不含标签)
* @returns {string} 截断后的合法HTML字符串
*/
function truncateHtmlString(html, maxLength) {
let result = '';
let tempBuffer = ''; // 缓存待确认输出的文本(含潜在句号前内容)
let tagMode = false; // 是否处于HTML标签内
let visibleCount = 0; // 已累计的可见字符数
// 第一遍:逐字符扫描,构建主结果 + 缓存未落定文本
for (const char of html) {
if (char === '<' || char === '>') {
tagMode = !tagMode;
tempBuffer += char;
result += char;
} else if (char === '.' && visibleCount < maxLength) {
// 遇到句号且未超限:立即提交缓存+句号,清空缓冲
result += tempBuffer + '.';
tempBuffer = '';
visibleCount++; // 句号计入长度
} else if (tagMode) {
// 标签内部字符(如 href="..." 中的内容)直接追加
tempBuffer += char;
result += char;
} else if (visibleCount < maxLength) {
// 普通文本且未超限:暂存入缓冲区
tempBuffer += char;
visibleCount++;
}
}
// 第二遍:处理剩余未提交的缓冲内容(仅补全标签,不新增可见字符)
tagMode = false;
for (const char of tempBuffer) {
if (char === '<' || char === '>') {
tagMode = !tagMode;
result += char;
} else if (tagMode) {
result += char;
}
// 非标签、非句号的剩余文本被丢弃(符合“不超过maxLength”原则)
}
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><p>This is a test message.<p>This is a test <a href="#">message.</a> </p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1349" title="依图语音开放平台"><img
src="https://img.php.cn/upload/ai_manual/001/431/639/68b6d607423ad747.png" alt="依图语音开放平台" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1349" title="依图语音开放平台">依图语音开放平台</a>
<p>依图语音开放平台</p>
</div>
<a href="/ai/1349" title="依图语音开放平台" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div></p>`;
console.log(truncateHtmlString(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><p>This is a test message.</p>关键设计说明:
- ✅ 标签零污染:通过 tagMode 状态精确区分标签与文本,确保 内外逻辑隔离;
- ✅ 句号优先策略:仅当句号出现且 visibleCount
- ✅ 闭合保障:第二遍扫描专为补全未闭合标签而设(如
开头但未到
),保证返回HTML可被浏览器安全解析; - ⚠️ 注意事项:
- 不处理自闭合标签(如
)的特殊语法,但现代浏览器普遍兼容
形式;
- 若原文无句号,函数退化为按字符数硬截断(仍保持标签完整);
- 对 等HTML实体,按原字符计数(如 占5字符),如需按渲染宽度处理,需额外解析实体。
- 不处理自闭合标签(如
该方案轻量、可靠、无外部依赖,可直接集成至任何前端项目,是处理CMS摘要、消息预览等场景的推荐实践。










