在网站内容运营中，我们经常会遇到这样的情况：为了保持页面布局的整洁和一致性，我们需要对过长的文本进行截断处理，例如在文章列表或产品摘要中。如果简单粗暴地截断，不仅可能导致文字含义不完整，还可能破坏包含HTML标签的文本结构，影响页面的美观和功能。

安企CMS以其灵活的模板引擎，为我们提供了优雅解决这一问题的方案。通过内置的文本过滤器，我们可以轻松地控制长文本的显示长度，并在适当的位置添加省略号，从而在不牺牲内容可读性的前提下，优化用户界面。今天，我们就来深入了解两个非常实用的文本处理工具：truncatechars 和 truncatewords 过滤器，以及它们各自的HTML友好版本。

truncatechars：按字符精准截断

truncatechars 过滤器能够按照您指定的字符数量来截断文本。它会从文本的开头开始计数，一旦达到您设定的字符数，就会在此处截断，并在末尾自动添加三个省略号（...）。

例如，如果您有一段文本：“安企CMS是一个功能强大的内容管理系统。”并且您希望它只显示前10个字符，可以这样使用：

{{ "安企CMS是一个功能强大的内容管理系统。"|truncatechars:10 }}

这段代码的输出结果会是：“安企CMS是一个功…”

需要注意的是，truncatechars 在计数时，会自动将末尾添加的三个省略号也计算在您设定的总字符数之内。这意味着，如果您设定截断为10个字符，实际显示的内容字符数将是7个字符加上3个省略号。

文本中包含HTML标签时的考量：truncatechars_html

如果您的文本内容中包含像 <b>（加粗）、<em>（斜体）或 <p>（段落）这样的HTML标签，直接使用 truncatechars 可能会导致HTML结构被破坏，例如标签没有正确闭合，从而引起页面显示异常。

为了避免这种情况，安企CMS提供了 truncatechars_html 过滤器。它能够智能地解析HTML结构，在截断时确保所有开启的标签都能正确闭合，从而保护页面的完整性。

例如，一段带有HTML标签的文本：“<p><b>安企CMS</b>是一个功能强大的内容管理系统，致力于提供高效解决方案。</p>”，如果希望截断前25个字符并保持HTML结构，可以这样使用：

{{ "<p><b>安企CMS</b>是一个功能强大的内容管理系统，致力于提供高效解决方案。</p>"|truncatechars_html:25 }}

它的输出结果会是：“<p><b>安企CMS</b>是一个功能强大...</p>”

可以看到，即使在截断后，<b>和<p>标签依然得到了正确的闭合，避免了页面错误。

truncatewords：按单词智能截断

与truncatechars按照字符截断不同，truncatewords 过滤器则是根据单词数量来截断文本。这对于英文内容尤其有用，因为它能够保持每个单词的完整性，避免出现半个单词的情况，从而让截断后的文本更具可读性。

例如，如果您有一段英文文本：“AnQiCMS is a powerful content management system.”，并希望它只显示前3个单词，可以这样使用：

{{ "AnQiCMS is a powerful content management system."|truncatewords:3 }}

输出结果会是：“AnQiCMS is a…”

与truncatechars不同，truncatewords在计数时，省略号不计入单词数量。这意味着，如果您设定截断为3个单词，实际显示的是3个完整的单词，然后额外加上省略号。

HTML文本的单词截断：truncatewords_html

同样地，当HTML内容需要按单词截断时，truncatewords_html 过滤器提供了与 truncatechars_html 类似的安全处理机制。它会识别并闭合文本中的HTML标签，同时按单词数量进行截断。

例如，一段包含HTML标签的英文文本：“<p><b>AnQiCMS</b> is a powerful content management system.</p>”，如果希望截断前5个单词并保持HTML结构：

{{ "<p><b>AnQiCMS</b> is a powerful content management system.</p>"|truncatewords_html:5 }}

输出结果会是：“<p><b>AnQiCMS</b> is a powerful content ...</p>”

在这里，HTML标签得到了妥善处理，同时文本也按单词数量进行了截断。

何时以及如何使用这些过滤器？

选择使用哪种过滤器，主要取决于您的具体需求和内容特性。

  • 需要严格控制显示区域的物理宽度时：truncatechars 或 truncatechars_html 通常是更好的选择，因为它按字符而非单词计数，能确保更一致的视觉长度。这在多语言网站中尤为重要，因为不同语言的单词长度差异很大。
  • 希望保持文本的语义完整性时：truncatewords 或 truncatewords_html 更为合适，尤其是在处理英文内容时，它能避免出现断裂的单词，使文本更自然。
  • 处理文章摘要、产品描述、评论预览等场景时：这些过滤器都能派上用场。它们帮助您在有限的空间内展示核心信息，引导用户点击查看详情。
  • 最重要的一点：如果您的内容中可能包含任何HTML标签（例如加粗、斜体、链接等格式），请务必使用带 _html 后缀的版本（例如 truncatechars_html 或 truncatewords_html）。这将确保在截断过程中，HTML标签能够正确闭合，避免页面布局混乱或功能异常。即使您不确定内容是否包含HTML，使用 _html 版本也是一个安全的**实践。

总而言之，truncatechars 和 truncatewords 及其HTML友好版本，是安企CMS内容运营的利器。它们能够帮助您轻松实现内容展示的精细化控制，提升网站的整体用户体验和专业度。

常见问题解答 (FAQ)

  1. 问：截断后的省略号“…”是否计入设定的长度？ 答：这取决于您使用的过滤器类型。对于truncatechars和truncatechars_html，是的，省略号