在网站运营中，我们经常需要在页面上展示各种文本内容，比如文章列表的摘要、产品介绍的预览，或者某个详情页面的简短描述。面对长篇幅的内容，如何在有限的空间内优雅地呈现其核心信息，并引导用户点击查看详情，是一个常见的需求。此时，对长文本内容进行截取并自动添加省略号就显得尤为重要。

安企CMS（AnQiCMS）作为一个高效、灵活的内容管理系统，充分考虑到了这一用户需求，提供了非常便捷且强大的内容过滤机制，可以帮助我们轻松实现这一目标。通过运用这些内置过滤器，我们不仅能优化页面布局、提升视觉美观度，还能显著改善用户体验，让信息传递更加高效。

为什么需要截取长文本内容？

内容截取并自动添加省略号，是提升网站用户体验和页面表现的关键一环。

首先，它能有效优化页面布局，避免信息过载。想象一下，在一个文章列表中，如果每篇文章的完整正文都直接显示出来，页面将会变得冗长不堪，用户很难快速浏览并找到感兴趣的内容。通过截取，我们可以在有限的屏幕空间内展示更多条目，提升页面的紧凑感和专业度。

其次，截取内容能够提高可读性和吸引力。一段精炼的摘要，更容易被用户快速消化，并激发他们点击“阅读更多”的欲望。这就像书籍的封面简介，恰到好处的留白和悬念，是引导用户深入了解的重要手段。

此外，对于搜索引擎优化（SEO）而言，精心截取的内容片段常被用作页面的元描述（Meta Description）或搜索结果摘要，这有助于吸引用户点击搜索结果，从而提升网站的流量。

安企CMS 提供的解决方案：内容截取过滤器

安企CMS内置了多款灵活的过滤器，专门用于处理长文本内容的截取和格式化。这些过滤器能够智能地判断文本长度，自动插入省略号（...），并且在使用时，我们还需要注意区分处理纯文本和含有HTML标签的富文本内容，以确保截取后的结构完整性。

安企CMS主要提供了以下几种核心截取过滤器：

  1. truncatechars: 按字符数截取。
  2. truncatewords: 按单词数截取。
  3. truncatechars_html: HTML安全地按字符数截取。
  4. truncatewords_html: HTML安全地按单词数截取。

接下来，我们将详细了解这些过滤器的使用方法。

1. truncatechars：按字符数截取

truncatechars 过滤器会根据您指定的字符数量来截取字符串。需要注意的是，它会将自动添加的省略号（...）计入总长度。如果原始内容的长度小于或等于指定长度，则不会进行截取。

使用方法： {{ 变量名|truncatechars:字符数量 }}

示例： 假设我们有一段长文本：“安企CMS 是一个基于 Go 语言开发的企业级内容管理系统，致力于提供高效、可定制、易扩展的内容管理解决方案。”

<p>
    {{ "安企CMS 是一个基于 Go 语言开发的企业级内容管理系统，致力于提供高效、可定制、易扩展的内容管理解决方案。"|truncatechars:20 }}
</p>

显示结果： 安企CMS 是一个基于 Go 语言开发的企业级…

2. truncatewords：按单词数截取

truncatewords 过滤器则根据您指定的单词数量来截取字符串。它的优势在于不会将一个单词截断，而是会保留完整的单词，并在最后一个完整单词后添加省略号。同样，省略号也会计入总长度。

使用方法： {{ 变量名|truncatewords:单词数量 }}

示例： 使用相同的文本内容：

<p>
    {{ "安企CMS 是一个基于 Go 语言开发的企业级内容管理系统，致力于提供高效、可定制、易扩展的内容管理解决方案。"|truncatewords:8 }}
</p>

显示结果： 安企CMS 是一个基于 Go 语言开发的企业级…

需要注意的是，对于中文文本，truncatewords 过滤器依赖空格来识别“单词”，如果一段连续的中文文本没有空格分隔，它可能会将其视为一个超长“单词”，导致截取效果不尽人意。在这种情况下，通常 truncatechars 会更适用。

3. truncatechars_html：HTML安全地按字符数截取

在处理包含HTML标签的富文本内容时，直接使用 truncatechars 或 truncatewords 可能会破坏HTML结构，导致页面显示异常。truncatechars_html 过滤器就是为了解决这个问题而设计的。它会在截取内容的同时，智能地保留并闭合所有未闭合的HTML标签，确保截取后的内容依然是有效的HTML。

特别提示： 凡是截取后可能包含HTML标签的内容，在模板输出时，都需要配合 |safe 过滤器，告知安企CMS这段内容是安全的，不需要进行HTML转义，从而让浏览器正确渲染。

使用方法： {{ 变量名|truncatechars_html:字符数量|safe }}

示例： 假设我们有一段包含HTML标签的文本：“

安企CMS 很棒！它提供了 灵活的内容模型 和强大的 SEO 工具。

”

<p>
    {{ "<p>安企CMS **很棒**！它提供了 <em>灵活的内容模型</em> 和强大的 SEO 工具。</p>"|truncatechars_html:25|safe }}
</p>

显示结果：

安企CMS 很棒！它提供了 灵活的内容模型…

4. truncatewords_html：HTML安全地按单词数截取

与 truncatechars_html 类似，truncatewords_html 过滤器是按单词数进行HTML安全截取。它同样会保留并闭合HTML标签，防止结构损坏。

使用方法： {{ 变量名|truncatewords_html:单词数量|safe }}

示例： 使用相同的包含HTML标签的文本：

<p>
    {{ "<p>安企CMS **很棒**！它提供了 <em>灵活的内容模型</em> 和强大的 SEO 工具。</p>"|truncatewords_html:8|safe }}
</p>

显示结果：

安企CMS 很棒！它提供了 灵活的内容模型 和…

实际应用场景与代码示例

在安企CMS的模板中，这些过滤器可以广泛应用于各种内容模块，例如：

1. 文章列表中的摘要显示

在文章或产品列表页，我们通常需要显示内容的简短摘要。

”`twig {# 假设您正在循环文档列表，并希望截取文档描述 #} {% archiveList archives with type=“page” limit=“10” %}

{% for item in archives %}
<div class="article-item">
    <a href="{{item.Link}}">
        <h3 class="article-title">{{item.Title}}</h3>
    </a>
    <p class="article-description">
        {# 截取文档描述的前100个字符