在网站内容呈现中，我们常常需要对一些较长的文本内容进行精炼，例如在文章列表页展示摘要，或者在产品卡片上显示简要描述。若直接展示全部内容，不仅可能破坏页面布局的整洁，也可能影响用户快速浏览信息的效率。因此，对过长的文本进行截断，并在末尾加上省略号，已成为提升用户体验的常见策略。安企CMS作为一款高效的内容管理系统，内置了灵活的模板过滤器，能够帮助我们轻松实现这一功能。

安企CMS的模板引擎提供了一系列强大的文本处理过滤器，其中用于文本截断并显示省略号的核心工具是 truncatechars 和 truncatewords。

truncatechars 过滤器顾名思义，是按照字符数量进行截断的。它会从文本的开头开始计数，计算到你指定的字符数后停止，并在截断位置自动添加上“…”省略号。无论是中文、英文、数字还是各类符号，都被视为一个字符单位。这个过滤器在需要精确控制文本显示长度，例如在卡片式布局中保持内容块高度一致时，显得尤为实用。

而 truncatewords 过滤器则以单词为单位进行截断。它会识别文本中的单词并进行计数，在你设定的单词数量处完成截断，同样也会在末尾附带省略号。这种方式对于主要以英文为内容的网站更加友好，因为它能够避免在单词中间进行不自然的截断，从而更好地保持文本的可读性和语义完整性。

然而，我们经常处理的文本内容并非总是纯粹的文字，它可能包含各种HTML标签，比如加粗、斜体、链接或者段落格式。如果直接使用上述纯文本截断过滤器，很可能会将这些HTML标签截断得不完整，从而导致页面渲染错误或样式混乱。

为了妥善处理富文本内容的截断，安企CMS进一步提供了 truncatechars_html 和 truncatewords_html 这两个高级过滤器。它们是HTML感知型的截断工具，能够在截断文本的同时，智能地检查并闭合任何未完成的HTML标签，确保输出的HTML片段依然是有效的，从而避免破坏页面结构。在使用这些HTML感知型过滤器后，为了让浏览器能够正确地解析并渲染其中的HTML内容，而不是将其当作纯文本显示，我们还需要在模板输出时，紧随其后地使用 |safe 过滤器。例如，你可以这样编写：{{ archive.Content|truncatechars_html:150|safe }}。

这些文本截断技巧在安企CMS的日常网站运营中应用广泛。比如，在文章或新闻列表页，我们可以使用 archive.Description|truncatechars:120 来显示每篇文章的摘要，既吸引用户点击，又能保持列表的整齐划一。在产品展示区域，对产品详情的简短描述进行截断，能够有效突出卖点而不占用过多空间。此外，对于分类或标签的简介、甚至过长的页面标题，都可以根据实际设计需求进行恰当的截断处理。

在选择合适的截断方式时，建议根据你的内容特性和设计目标来决定。如果你对文本的显示宽度有精确要求，或者处理的是中文内容，那么 truncatechars（或 truncatechars_html）通常是更合适的选择，因为它能按字符精细控制。如果你的内容主要是英文，并且希望保持单词的完整性，那么 truncatewords（或 truncatewords_html）会提供更佳的阅读体验。始终记住，只要文本内容可能含有HTML标签，就应优先选用带有 _html 后缀的过滤器，并配合 |safe 确保渲染正确。

将这些过滤器整合到安企CMS的模板中非常直观。你只需在需要处理的变量后，通过管道符 | 连接对应的过滤器和参数即可。例如，展示一篇文档的摘要：

<p class="article-summary">{{ article.Description|truncatechars:150 }}</p>

{# 如果是带有HTML格式的内容，并且希望保留格式 #}
<div class="product-brief">{{ product.Content|truncatechars_html:200|safe }}</div>

{# 针对英文标题，按单词截断 #}
<h2>{{ news.Title|truncatewords:8 }}</h2>

通过这样的方式，安企CMS让内容运营人员能够灵活地控制网站前端内容的表现形式，在不改变原始内容的前提下，有效提升网站的视觉美感和用户体验。

常见问题 (FAQ)

  1. 问：为什么我使用 truncatechars_html 截断富文本内容后，文本末尾却没有显示省略号？ 答：truncatechars_html 和 truncatewords_html 过滤器会自动在截断内容后添加省略号。如果您的原始内容（在解析HTML标签后的实际可见字符数量）本身就小于或等于您设定的截断长度，那么过滤器就不会进行实际的截断操作，因此也就不会显示省略号。省略号只会在内容被实际缩短时才会出现。

  2. 问：我截断了包含HTML标签的文本，但页面上显示的是原始的HTML标签代码，而不是渲染后的格式效果。这是什么原因？ 答：这通常是因为安企CMS的模板引擎出于安全考虑，默认会对所有输出内容进行HTML转义，以防止跨站脚本（XSS）攻击。当您使用 truncatechars_html 或 truncatewords_html 过滤器处理富文本后，输出的结果仍然被系统视为可能包含未经检查的HTML，并因此被转义。