在网站运营中，我们经常需要在一个页面上展示大量内容的摘要，比如首页的文章列表，产品详情页的简短介绍，或者某个模块的推荐内容。这些摘要既要能吸引读者点击，又要保持页面布局的整洁美观。然而，当这些内容本身包含丰富的HTML格式（例如，加粗、斜体、图片、链接等）时，直接简单地截取字符长度往往会带来一个令人头疼的问题：HTML标签结构被破坏，导致页面显示错乱，甚至影响整体样式。
想象一下，一篇精心排版的文章，摘要却因为截取不当，留下了一个未闭合的<div>标签，或者一个只显示了半截的图片标签<img src="..." alt="...。这样的结果不仅极大地影响了用户体验，让页面看起来杂乱无章，对于搜索引擎优化（SEO）来说，也可能造成负面影响，因为搜索引擎更倾向于抓取结构良好、代码规范的页面。
安企CMS的模板系统，借鉴了Django的灵活语法，其中就有一个名为truncatechars_html的实用过滤器，它正是为了解决上述难题而生。这个过滤器能够智能地截取包含HTML标签的内容，同时确保被截取后的HTML代码依然是完整且有效的，不会破坏原有的标签结构。
truncatechars_html 如何保障HTML内容的截取安全
truncatechars_html过滤器的使用方法非常直观。您只需要将需要截取的内容变量，通过管道符|，传递给truncatechars_html，并指定您希望截取的“可见字符”长度即可。
例如，您的文章内容存储在article.Content变量中，并且您想截取前120个可见字符作为摘要：
{{ article.Content|truncatechars_html:120|safe }}
这里的关键在于truncatechars_html的“智能”之处。它不仅仅是简单地从头开始数120个字符然后一刀切断。相反，它会：
- 识别HTML标签：它知道哪些是HTML标签（例如
<strong>、<a>、<p>），哪些是实际的文本内容。 - 计算可见字符：在计数时，它只计算用户能看到的文本字符，而忽略HTML标签本身所占的字符。
- 安全截断：当截取到指定长度时，如果截断位置恰好在一个HTML标签的中间，
truncatechars_html会智能地调整截断点，确保不会把标签截断成不完整的片段。 - 自动闭合标签：更重要的是，如果截断后留下了任何未闭合的HTML标签（例如
<div>标签被打开了但没有对应的</div>），它会自动在内容末尾添加正确的闭合标签，从而确保生成的内容片段是一个结构完整的HTML代码块。 - 添加省略号：默认情况下，如果内容被截断，
truncatechars_html会在截取内容的末尾添加“…”以示内容未完。
让我们通过一个简单的例子来体会它的魔力。假设您有一段HTML内容：
<div class="foo">
<p>这是一段很长的<b>测试文本</b>，它会被安全地截取，而不会破坏HTML结构。</p>
<ul>
<li>列表项1</li>
<li>列表项2</li>
</ul>
</div>
如果您使用truncatechars_html:25来截取这段内容：
{{ "<div class=\"foo\"><p>这是一段很长的<b>测试文本</b>，它会被安全地截取，而不会破坏HTML结构。</p><ul><li>列表项1</li><li>列表项2</li></ul></div>"|truncatechars_html:25|safe }}
输出的结果会是这样（为了可读性进行简化，实际可能根据具体内容和截断点略有不同）：
<div class="foo"><p>这是一段很长的<b>测试文本</b>，它会被安全地截取，而不会破...</p></div>
可以看到，即便原始的<ul>和<li>标签可能在截断点之后，但<div>和<p>标签都得到了正确的闭合，保证了HTML结构的完整性。而如果使用普通的truncatechars过滤器，很可能会在<p>标签内部或者<b>标签中间直接截断，导致HTML渲染错误。
实际应用场景
truncatechars_html在安企CMS的日常内容运营中有着广泛的应用：
- 文章列表页的摘要：在博客或新闻列表页，展示每篇文章的精简版内容，既能提供关键信息，又避免了长内容撑开布局。
- 产品列表的简短描述：在电商网站的产品列表页，展示产品的核心卖点，同时保持页面加载速度和美观。
- 搜索结果预览：在站内搜索结果中，为用户提供相关内容的片段，帮助他们快速判断是否是需要的信息。
- 推荐模块内容：在侧边栏、底部推荐等模块，展示相关内容的精要，吸引用户点击。
通过这个过滤器，内容运营者可以放心地在后台使用富文本编辑器创建丰富多彩的内容，而在前端展示时，无需担心复杂的截取逻辑，truncatechars_html会智能地处理好一切，让您的网站始终保持专业和整洁。
常见问题 (FAQ)
1. truncatechars_html会截断中文字符吗？它是如何计算长度的？
是的，truncatechars_html能够正确地截断中文字符。它在计算长度时，是基于“字符”而不是“字节”来计算的。这意味着一个汉字和一个英文字母都会被计算为1个字符，确保了在多语言环境下截取长度的一致性和准确性。
2. 如果内容本身的可见字符长度就少于我设定的截取长度，还会添加“…”吗？
不会。truncatechars_html非常智能，只有当实际截取了内容（即原始内容的可见字符长度超过了您设定的长度）时，才会在截取内容的末尾添加省略号“…”。如果原始内容本身就比较短，未达到您设定的截取长度，那么它会原样输出，不会画蛇添足地添加省略号。
3. truncatechars_html和truncatewords_html有什么区别？我应该选择哪一个？
这两者都是用于安全截取HTML内容的过滤器，主要区别在于它们截取的单位不同：
truncatechars_html：按字符长度截取。它会从头开始计算可见字符数，达到指定长度后安全截断。即使截断点在一个单词的中间，它也会保留前面的部分并添加省略号。truncatewords_html：按单词数量截取。它会计算可见单词的数量，达到指定单词数后安全截断。这种方式会确保截取的内容以完整的单词结束。 选择哪一个取决于您的具体需求。如果您对长度有严格的字符限制（例如固定宽度的卡片显示），truncatechars_html可能更合适。如果您更注重内容的语意完整性，希望摘要总是以完整的单词结束，那么truncatewords_html会是更好的选择。