在安企CMS中，作为一名资深的网站运营人员，我们深知如何通过精确的内容展示来提升用户体验。在诸多内容管理场景中，文章摘要、产品简介或列表页面预览的文字长度控制，是确保页面整洁美观和信息高效传达的关键环节。为了避免过长的文本影响布局，同时又不失内容的连贯性，对字符串进行指定长度或单词数量的截取，并在末尾自动添加省略号，是AnQiCMS模板开发中非常实用的技巧。
AnQiCMS的模板引擎提供了强大的过滤器功能，可以方便地对输出的变量进行格式化和处理。对于字符串截取的需求，我们主要会用到truncatechars和truncatewords这两个过滤器。
字符串按字符长度截取并添加省略号
当我们希望将一段文本内容限制在固定的字符数内进行显示时，可以使用truncatechars过滤器。这个过滤器会根据您指定的字符数量来截取字符串，如果原始字符串的长度超过了指定数量，它会在截取后的末尾自动加上一个省略号（“…”），从而清晰地指示内容已被省略。
例如，您在文章列表页需要显示每篇文章的简介，但为了保持页面布局的统一，希望简介最多显示一百个字符。此时，您可以像下面这样在模板中应用truncatechars过滤器：
{{ item.Description|truncatechars:100 }}
在这个示例中，item.Description代表了文章的简介内容。通过|truncatechars:100，AnQiCMS会自动将该简介截取到最多一百个字符，并智能地在末尾加上省略号，如果简介本身就少于一百个字符，则会完整显示而不会添加省略号。
字符串按单词数量截取并添加省略号
与按字符截取不同，有时我们更倾向于按单词数量来控制文本长度，这在英文或其他以单词为基本单位的语言内容中尤为常见，可以更好地保持语义的完整性。truncatewords过滤器正是为此目的而设计。它会计算字符串中的单词数量，并根据您指定的数字进行截取，同样会在末尾自动添加省略号。
如果您有一个产品描述字段，并且希望在产品列表页显示一个包含二十个单词的简短描述，那么可以在模板中这样使用truncatewords：
{{ product.Description|truncatewords:20 }}
这里的product.Description代表产品描述。|truncatewords:20会确保描述内容最多由二十个单词组成，并同样在必要时附加省略号。
处理包含HTML标签的内容截取
在实际的网站运营中，很多内容字段（例如文章正文、富文本编辑器生成的简介）可能包含HTML标签。如果直接使用truncatechars或truncatewords对这类内容进行截取，有可能会破坏HTML结构，导致页面显示异常。为了解决这个问题，AnQiCMS还提供了针对HTML内容优化的过滤器：truncatechars_html和truncatewords_html。
这两个过滤器在截取HTML字符串时，会智能地解析HTML结构，确保在截断文本的同时，所有开启的HTML标签都能被正确关闭，从而避免因标签未闭合导致的页面混乱。在输出这类截取后的内容时，为了确保HTML标签能够正常渲染而不是被当作纯文本显示，通常还需要配合使用|safe过滤器。
例如，要截取一段包含HTML的正文内容，并限制在两百个字符以内，同时保持HTML结构完整：
{{ archive.Content|truncatechars_html:200|safe }}
同样，如果您希望按单词数量来截取包含HTML的内容：
{{ archive.Content|truncatewords_html:30|safe }}
通过这些过滤器，您可以灵活地控制AnQiCMS网站内容的显示长度，无论是纯文本还是富含HTML结构的内容，都能以优雅、结构完整的方式呈现在用户面前，从而优化页面的视觉效果和用户阅读体验。在进行内容运营和模板设计时，合理运用这些字符串截取功能，将大大提高您网站内容的专业度和吸引力。
常见问题解答
问：如果我的文本内容本身就比我设定的截取长度短，还会显示省略号吗？ 答：不会。AnQiCMS的这些截取过滤器非常智能。如果原始内容的长度（无论是字符数还是单词数）没有超过您设定的限制，过滤器会原样输出文本，而不会在末尾添加省略号。省略号只会在内容实际被截断时出现，以提示读者内容是未完的。
问：我可以在同一个模板变量上连续使用多个过滤器吗？
答：是的，AnQiCMS的模板引擎支持过滤器链式调用。您可以将多个过滤器通过|符号连接起来，它们将按照从左到右的顺序依次对变量进行处理。例如，您可能希望将文本转换为小写后，再进行截取：{{ item.Title|lower|truncatechars:50 }}。
问：truncatechars_html和truncatewords_html过滤器能处理所有复杂的HTML结构吗？例如嵌套的div、script标签等？
答：_html系列过滤器旨在尽可能地保持HTML结构的完整性，尤其擅长处理常见的文本格式标签（如<b>、<i>、<a>、<p>等）。然而，对于非常复杂或包含嵌入式脚本的HTML结构，虽然它们会努力关闭标签以防止页面渲染错误，但过度复杂的HTML内容在强制截取时仍可能导致显示上的细微差异。因此，对于包含复杂交互或脚本的内容，建议在截取前对其进行预处理或考虑不进行截取，以确保功能不受影响。