在网站内容的日常管理中，我们经常会遇到这样的情况：一篇文章的简介、一段产品的描述，或是某个列表项的标题，如果内容过长，不仅会占用过多的页面空间，还可能破坏整体布局的美观性。尤其是在手机等小屏幕设备上，过长的文本更是会严重影响用户体验。如何优雅地截断这些文本，并添加上常见的省略号（…），让信息既完整又整洁，是内容运营中一个很实用的技巧。

安企CMS作为一款高效的内容管理系统，深知用户对内容展示灵活性的需求。其强大的模板引擎提供了一系列内置的过滤器（Filters），能够帮助我们轻松实现文本的截断与省略号的添加，确保网站内容无论在何种场景下都能呈现出**状态。

精准字符截断：truncatechars 过滤器

如果您需要根据精确的字符数量来截断文本，例如要求每篇文章摘要严格控制在50个字符以内，那么truncatechars过滤器就是您的理想选择。它会从文本的开头开始计算字符，当达到您指定的长度时进行截断，并在末尾自动加上省略号。值得注意的是，您设置的截断长度是包含这个省略号在内的。

使用方法非常直观，只需在您要处理的文本变量后面加上|truncatechars:数字即可。比如，您想在文章列表中显示每篇文章的前50个字符作为简介：

{{ item.Description|truncatechars:50 }}

这会将item.Description的内容截断，并确保最终显示的字符串（包括省略号）不超过50个字符，让列表页看起来更加整齐划一。

自然单词截断：truncatewords 过滤器

有时候，单纯按字符数量截断可能会导致一个词被“拦腰截断”，影响阅读体验。如果您的内容更注重语义的完整性，希望截断处能更自然地停在一个词的结尾，那么truncatewords过滤器会是更好的选择。它会根据单词的数量来截断文本，避免单词被生硬地切分，让截断后的内容更具可读性。

例如，您希望文章标题在某个区域显示最多10个单词：

{{ item.Title|truncatewords:10 }}

它会智能地寻找第10个单词的结尾处进行截断，并在末尾添加省略号，避免出现“安企CM…”这样不完整的词语，让内容呈现更加流畅自然。

应对复杂HTML：truncatechars_html 与 truncatewords_html

在安企CMS中，很多内容都是通过富文本编辑器输入的，这意味着它们包含了丰富的HTML标签（如<p>, <strong>, <img>等）。直接对含有HTML标签的文本使用truncatechars或truncatewords可能会破坏其结构，导致页面显示异常甚至错乱。

为了解决这个问题，安企CMS提供了专门处理HTML内容的过滤器：truncatechars_html 和 truncatewords_html。它们在截断文本的同时，会智能地闭合所有被截断的HTML标签，确保最终输出的HTML代码是完整且有效的。

一个非常重要的提示： 当您使用这两个过滤器处理HTML内容时，务必配合|safe过滤器一起使用。|safe的作用是告诉模板引擎，这部分内容是安全的HTML代码，不需要进行转义处理，否则浏览器会把HTML标签当作普通文本显示出来。

例如，您想截断一篇包含丰富格式的文章内容作为摘要，并确保HTML标签不被破坏：

{{ archive.Content|truncatechars_html:120|safe }}

或者按单词截断：

{{ archive.Content|truncatewords_html:30|safe }}

这样，即使原文中的HTML标签被截断，这些过滤器也会保证如<div>、<span>等标签能够正确闭合，不会影响页面的整体布局和样式。

小贴士与实践建议

  • 灵活选择： 对于纯文本内容（如Description），可以根据需求选择truncatechars或truncatewords。对于富文本内容（如Content），请务必使用truncatechars_html或truncatewords_html。
  • 别忘了 |safe： 再次强调，处理HTML内容时，|safe是不可或缺的，它能确保您的HTML代码被浏览器正确解析。
  • 测试不同长度： 在实际应用中，建议您在测试环境中尝试不同的截断长度，以找到最适合您网站设计和内容风格的显示效果。
  • 结合安企CMS后台设置： 安企CMS后台的内容设置中，您可以为文档设置默认缩略图或自动提取简介。虽然这些功能提供了便捷，但在特定模板区域需要更精细的文本控制时，直接在模板中使用这些过滤器将为您提供更大的灵活性。

通过巧妙地运用这些文本截断过滤器，您不仅能保持安企CMS网站版面的美观，还能提升用户阅读体验，让信息传达更高效，无论是文章列表、产品展示还是其他内容板块，都能呈现出专业且引人入胜的效果。

常见问题 (FAQ)

1. 截断中文内容时，一个汉字算几个字符？

在安企CMS的truncatechars和truncatechars_html过滤器中，一个中文字符通常被视为一个字符（rune）进行计数。这意味着您设置的长度将直接对应显示的中文字符数量，而不会因为多字节编码而产生偏差。

2. 为什么截断 HTML 内容后，有时会出现标签断裂或页面样式混乱？

这通常是因为在处理含有HTML内容的变量时，忘记或者错误使用了|safe过滤器。当没有|safe时，模板引擎会将HTML标签视为普通文本进行转义，导致浏览器无法正确解析和渲染。同时，即使使用了|safe，如果截断的长度过短，也可能导致一些复杂嵌套的HTML结构无法完美闭合，尽管_html系列过滤器会尽力处理，但仍建议设置一个合理的截断长度。

3. 截断时添加的省略号（…）会占用我设置的截断长度吗？

是的，无论是truncatechars还是truncatewords系列过滤器，其在文本末尾自动添加的省略号（通常是三个点）都会计入您所设定的总长度中。例如，如果您设置|truncatechars:50，那么最终显示的内容（包括省略号）总长度将是50个字符。