本文详解如何修复原生 javascript 文本截断逻辑中因空字符串导致的过早截断问题，并提供结构安全、语义清晰、可复用的 html 内容按词截断方案。
本文详解如何修复原生 javascript 文本截断逻辑中因空字符串导致的过早截断问题，并提供结构安全、语义清晰、可复用的 html 内容按词截断方案。
在实现 HTML 元素内文本按单词数截断（如 data-limit="10"）时，一个常见却隐蔽的陷阱是：textContent.split(/\s+/) 会将连续空白符（如换行、缩进、多个空格）解析为大量空字符串。例如 <div>\n Hello world \n</div> 的 nodeValue 可能为 "\n Hello world \n"，经 .split(/\s+/) 后得到 ["", "", "Hello", "world", "", ""] —— 若不校验空项，"" 也会被计为“单词”，导致 wordCount 提前达到上限，从而在首段文字前就插入 ...，甚至跳过全部可见内容。
✅ 核心修复：过滤空字符串
只需在遍历分割后的单词数组时，增加对 words[i] 的真值判断：
const words = node.nodeValue.split(/\s+/);
for (let i = 0; i < words.length; i++) {
// ✅ 关键修复：跳过空字符串（由换行/缩进/多余空格产生）
if (words[i] && wordCount < limit) {
truncatedContent += words[i] + ' ';
wordCount++;
} else if (wordCount >= limit) {
truncatedContent += '... ';
return;
}
}该判断确保仅统计非空、有意义的单词，彻底避免因 HTML 源码格式（如换行缩进）引发的误截断。
? 完整健壮实现要点
以下为优化后的核心逻辑说明（已整合进最终代码）：
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
保留 HTML 结构完整性：递归遍历所有子节点（
Node.ELEMENT_NODE），原样序列化标签、属性与嵌套内容，仅对纯文本节点（Node.TEXT_NODE）执行单词级截断； -
跳过干扰元素：显式忽略已存在的
<span class="more"></span>，防止重复插入； -
安全还原机制：使用
dataset.originalContent存储原始innerHTML，点击“Read more”时直接恢复，无 DOM 重建风险； -
事件委托优化：监听
.shorten-text容器的冒泡点击，精准捕获.more元素，避免为每个链接重复绑定。
? 使用示例与注意事项
<div class="shorten-text" data-limit="8"> <h2>简介</h2> <p>这是一个<strong>支持内联标签</strong>的段落，包含<a href="#">链接</a>与强调文本。</p> <p>第二段将被截断——它本应展示更多细节，但受限于字数。</p> </div>
✅ 预期效果：截断发生在第 8 个有效单词后（如 "…细节，但受..."），<h2></h2>、<strong></strong>、<a></a> 等标签完整保留，结构零破坏。
⚠️ 注意事项：
- 避免在
data-limit中传入非数字值（parseInt()已做容错，但建议始终使用整数）； - 截断逻辑作用于整个
.shorten-text元素的直系文本内容总和，而非单个<p></p>或<div>；<li>若需更精细控制（如按段落优先截断），需扩展策略，当前方案以语义流为单位最符合阅读习惯。</li> <p>通过这一修复，你的文本截断功能将真正实现「按需截词、保形保意、即点即展」，成为可稳定集成于任何静态页面或轻量级应用中的可靠组件。</p> </div>
