在制作网站模板时，我们经常需要控制文本的显示长度，以确保页面布局美观、信息传达高效。比如，限制文章摘要的字数，确保导航菜单的文本不会过长，或者在表单提交前进行字符数验证。安企CMS的模板引擎提供了一个非常实用的过滤器——length，它可以帮助我们轻松获取字符串、数组或键值对的实际字符长度，并且对中文支持良好。这意味着，无论是英文、数字还是中文字符，它都会将每个字符计算为一个长度单位。

核心工具：length 过滤器

当您需要知道任何字符串、数组或键值对的实际长度时，length 过滤器是您的首选。它能够准确地统计出变量所包含的字符数量或元素个数。尤其值得一提的是，安企CMS的模板文件统一采用UTF-8编码，所以length过滤器在处理中文字符时，一个汉字也只算作一个字符长度，这极大地简化了多语言或包含中文内容的网站开发工作，让您无需担心字符编码带来的长度计算问题。

使用方法非常直观，只需在您想要获取长度的变量后添加|length即可：

{{ 变量 | length }}

示例演示：

让我们通过一些具体的例子来看看length过滤器是如何工作的：

{# 获取英文字符串长度 #}
<p>英文字符串 "Hello AnQiCMS" 的长度是：{{ "Hello AnQiCMS" | length }}</p> {# 输出: 13 #}

{# 获取中文字符串长度 #}
<p>中文字符串 "你好安企CMS" 的长度是：{{ "你好安企CMS" | length }}</p> {# 输出: 6 #}

{# 获取中英文混合字符串长度 #}
<p>中英文混合字符串 "Hello 你好 AnQiCMS" 的长度是：{{ "Hello 你好 AnQiCMS" | length }}</p> {# 输出: 14 #}

{# 获取数字字符串长度（按字符） #}
<p>数字字符串 "12345" 的长度是：{{ "12345" | length }}</p> {# 输出: 5 #}

{# 获取数组（slice）的元素数量 #}
{% set my_list = ["apple", "banana", "orange"] %}
<p>数组中的元素数量是：{{ my_list | length }}</p> {# 输出: 3 #}

{# 获取键值对（map）的键数量 #}
{% set my_map = {"name": "AnQiCMS", "version": "3.x"} %}
<p>键值对中的键数量是：{{ my_map | length }}</p> {# 输出: 2 #}

从上面的示例中，您可以看到length过滤器能够非常准确且便捷地返回不同类型数据的实际长度，无论是单一字符、中文汉字还是数组元素。

进阶用法：length_is 过滤器

在某些场景下，您可能不仅需要获取长度，还需要判断一个字符串的长度是否等于某个特定值。这时，length_is过滤器就能派上用场了。它会比较变量的长度与您指定的值，并返回一个布尔值（True 或 False）。

使用方法如下：

{{ 变量 | length_is: 期望长度 }}

示例演示：

结合length_is过滤器和条件判断，可以实现更灵活的模板逻辑：

{# 判断字符串长度是否为特定值 #}
<p>"AnQiCMS" 的长度是否为 7：{{ "AnQiCMS" | length_is: 7 }}</p> {# 输出: True #}
<p>"AnQiCMS" 的长度是否为 8：{{ "AnQiCMS" | length_is: 8 }}</p> {# 输出: False #}

{# 判断中文字符串长度 #}
<p>"安企CMS" 的长度是否为 6：{{ "安企CMS" | length_is: 6 }}</p> {# 输出: True #}

{# 结合 if 语句使用 #}
{% set site_name = "我的安企网站" %}
{% if site_name | length_is: 6 %}
  <p>网站名称 "我的安企网站" 长度恰好为6个字符。</p>
{% else %}
  <p>网站名称 "我的安企网站" 长度不是6个字符。</p>
{% endif %}

实际应用场景

length和length_is这些长度过滤器在模板设计中用途广泛。例如，在列表页展示文章摘要时，您可以结合truncatechars过滤器和length过滤器，确保摘要既不超出最大长度，又能根据实际内容动态调整显示，避免出现不必要的省略号。您还可以用于表单验证，在客户端提前提示用户输入内容的长度限制，提升用户体验。对于响应式设计，动态调整元素内容，避免布局破损也很有帮助。

总结

通过length和length_is这两个简单而强大的过滤器，您可以精确地控制模板中字符串和数据结构的长度，无论是纯英文还是包含复杂中文的场景，都能得心应手地处理，从而创建出功能完善、用户体验良好的网站。

常见问题 (FAQ)

  1. length 过滤器是否会计算HTML标签的长度？ 不，length过滤器计算的是字符串内容的实际字符数，而不是包含HTML标签在内的原始字符串的字节长度。如果您将一个包含HTML标签的字符串（例如<b>Hello</b>）直接传递给length过滤器，它会将其视为11个字符（包括<、>、b等）。如果您希望获取去除HTML标签后的纯文本长度，需要先使用striptags过滤器去除