在网站运营中，我们经常会遇到需要展示一段文字，但又不能让它过长，以免影响页面布局或阅读体验的情况。无论是文章标题、摘要，还是产品描述，如果内容超出了预期的长度，通常的做法是截取一部分，并在末尾加上省略号，以示意内容尚未结束。对于AnQiCMS的用户来说，实现这样的效果并不复杂，得益于其灵活强大的模板引擎，我们有多种内置的过滤器（Filters）可以轻松应对。

AnQiCMS的模板引擎设计得非常实用，它允许开发者和运营者通过简单的语法对变量进行处理，包括我们今天要探讨的字符串截取和省略号添加。这些过滤器能够帮助我们高效地管理内容在前端的展示方式，提升用户体验和页面整洁度。

如何截取纯文本字符串并添加省略号

对于不包含任何HTML标签的纯文本内容，AnQiCMS提供了两个非常方便的过滤器来处理：truncatechars和truncatewords。

  1. 按字符截取：truncatechars 顾名思义，truncatechars过滤器会根据您指定的字符数来截取字符串。它会将末尾自动添加的省略号（通常是3个字符）也计算在总长度之内。这意味着，如果您指定截取20个字符，最终显示的内容（包括省略号）总长度不会超过20个字符。

    使用方法： {{ 你的变量|truncatechars:长度 }}

    例如，假设您的文章标题archive.Title是“安企CMS：一款高效的企业级内容管理系统，助您轻松管理网站内容。”如果您想将它截取为最多15个字符显示，可以这样写： {{ archive.Title|truncatechars:15 }}

    处理后的结果可能是：“安企CMS：一款高效…”

  2. 按单词截取：truncatewords 与truncatechars不同，truncatewords过滤器会尝试在单词边界处截取字符串，这样可以避免一个单词被硬生生地从中间截断，使得文本在英文语境下阅读起来更加自然流畅。它同样会将省略号计算在指定的单词数内。

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

    假设您有一段英文描述archive.Description是“AnQiCMS is a powerful and flexible content management system developed with Go language, offering efficient solutions for SMEs.”，如果您需要显示前10个单词，可以这样操作： {{ archive.Description|truncatewords:10 }}

    处理后的结果可能是：“AnQiCMS is a powerful and flexible content management system developed with Go language…”

如何截取包含HTML内容的字符串并添加省略号

在很多网站内容管理场景中，文章的摘要或产品描述可能包含图片、链接、加粗文本等HTML标签。如果直接使用truncatechars或truncatewords来处理这些内容，很可能会破坏HTML结构，导致页面显示混乱或不完整。

为了避免这种情况，AnQiCMS贴心地提供了专门处理HTML内容的过滤器：truncatechars_html和truncatewords_html。

  1. 按字符截取HTML：truncatechars_html 这个过滤器与truncatechars的功能类似，但它会智能地识别并闭合未结束的HTML标签。这样在截取含有HTML标签的字符串时，就能保证输出的HTML结构依然有效。同时，省略号也会被计算在指定字符长度内。

    使用方法： {{ 你的HTML变量|truncatechars_html:长度|safe }}

    请注意，在使用_html后缀的过滤器处理HTML内容时，务必在最后加上|safe过滤器。safe过滤器告诉AnQiCMS模板引擎，这段内容是安全的HTML代码，不需要进行额外的转义处理，应该直接解析为HTML。

    例如，如果archive.Content包含<p>这里是<b>一段长长的文本，其中包含<i>各种有趣的</i>内容</b>。</p>，并且您想截取为最多30个字符： {{ archive.Content|truncatechars_html:30|safe }}

    处理后的结果可能是：<p>这里是<b>一段长长的文本，其中包含<i>各种...</i></b></p>，可以看到HTML标签被正确地闭合了。

  2. 按单词截取HTML：truncatewords_html 与truncatewords相似，但它适用于包含HTML标签的内容，并会努力在单词边界和正确的HTML标签结构下进行截取。它也需要|safe过滤器来正确解析HTML。

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

    例如，如果archive.Content是<p>AnQiCMS is a <b>powerful and flexible</b> content management system.</p>，您想截取前5个单词： {{ archive.Content|truncatewords_html:5|safe }}

    处理后的结果可能是：<p>AnQiCMS is a <b>powerful and...</b></p>

实际应用场景与小贴士

在AnQiCMS的模板开发中，这些截取过滤器是内容展示优化的利器。它们通常用于：

  • 文章列表页的摘要： 统一摘要长度，使页面排版更整齐。
  • 产品列表页的简要描述： 快速浏览产品亮点，吸引用户点击。
  • 任何需要缩略展示文本的场景： 避免过长的文本占用过多空间。

小贴士：

  • 选择合适的过滤器： 对于纯文本，选择truncatechars或truncatewords；对于包含HTML的内容，请使用truncatechars_html或truncatewords_html，并始终配合|safe。
  • 考虑语言特性： 对于中文内容，truncatechars通常更常用，因为它没有“单词”的概念；而对于英文内容，truncatewords往往能提供更自然的截取效果。
  • 测试效果： 在实际应用时，最好在不同长度的内容上测试截取效果，以确保满足您的设计和用户体验需求。

掌握这些字符串截取过滤器，能让您在AnQiCMS的内容呈现上更加灵活和高效，轻松打造出既美观又实用的网站页面。

常见问题 (FAQ)

Q1：为什么我截取HTML内容时，页面显示乱了或者标签没有闭合？ A1：这很可能是因为您使用了truncatechars或truncatewords来处理包含HTML标签的内容。这些过滤器不具备识别和处理HTML结构的能力，可能会导致标签被截断在中间。请改用truncatechars_html或truncatewords_html，并确保在输出时加上|safe过滤器，例如{{ 你的HTML变量|truncatechars_html:长度|safe }}。|safe过滤器指示模板引擎将内容作为原始HTML渲染，而不是将其转义。