`length` 过滤器在 AnQiCMS 模板中如何判断数组或字符串是否为空？

在安企CMS的模板开发中，我们经常需要根据数据的存在与否来决定页面的显示内容，比如一个文章列表，如果列表为空，我们可能需要显示“暂无内容”而不是一个空白区域。这时，length 过滤器就成了我们的得力助手，它能帮助我们轻松判断数组、字符串等数据是否为空。

认识 length 过滤器

length 过滤器是安企CMS模板引擎提供的一个非常实用的功能，它的主要作用是返回一个变量的长度。这个“长度”根据变量的类型有所不同：

• 对于字符串： length 会计算字符串中实际的字符数量。无论是英文字母、数字还是中文字符，length 都会将其视为一个字符进行计数。
• 对于数组或切片（Slice）： length 会返回数组或切片中包含的元素总数。
• 对于键值对（Map）： length 则会返回键值对中键值对的数量。

它的基本使用语法非常直观：

{{ 变量 | length }}

举个例子，如果您的模板中有一个字符串 someText = "Hello AnQiCMS"，那么 {{ someText|length }} 将输出 13。如果字符串是 chineseText = "你好安企CMS"，那么 {{ chineseText|length }} 也将输出 6，这体现了它对多语言字符的友好支持。同样地，如果有一个数组 myList = ["item1", "item2"]，{{ myList|length }} 将返回 2。

如何判断数组或字符串是否为空

掌握了 length 过滤器的基本用法后，我们就可以将其灵活运用到判断数据是否为空的场景中。

1. 判断字符串是否为空

判断一个字符串是否为空通常有两种非常方便的方式：

方式一：使用 length 过滤器结合 if 语句 这种方法直接获取字符串长度，并与 0 进行比较。当长度为 0 时，即表示字符串为空。

{% set articleTitle = "安企CMS模板开发指南" %}
{# 或者 {% set articleTitle = "" %} #}

{% if articleTitle|length == 0 %}
    <p>抱歉，文章标题是空的。</p>
{% else %}
    <h1>{{ articleTitle }}</h1>
{% endif %}

方式二：直接在 if 语句中判断字符串 在安企CMS的模板引擎中，非空字符串会被视为“真值”（true），而空字符串则被视为“假值”（false）。因此，您可以更简洁地直接将字符串变量作为 if 语句的条件。

{% set authorName = "安企小助手" %}
{# 或者 {% set authorName = "" %} #}

{% if authorName %}
    <p>作者：{{ authorName }}</p>
{% else %}
    <p>作者未知。</p>
{% endif %}

这种方式通常更为推荐，因为它代码量更少，可读性更强。

2. 判断数组（或切片）是否为空

对于数组或切片，判断其是否为空的方法同样多样且实用：

方式一：使用 length 过滤器结合 if 语句 与字符串类似，获取数组的元素数量并判断是否为 0。

{% set productList = ["产品A", "产品B"] %}
{# 或者 {% set productList = [] %} #}

{% if productList|length == 0 %}
    <p>当前没有可用的产品。</p>
{% else %}
    <ul>
    {% for product in productList %}
        <li>{{ product }}</li>
    {% endfor %}
    </ul>
{% endif %}

方式二：利用 for 循环的 empty 语法 这是在循环显示列表数据时，判断列表是否为空的最推荐方式。当 for 循环遍历的数据集为空时，{% empty %} 块内的内容会自动被执行。

{% set commentList = ["评论1", "评论2"] %}
{# 或者 {% set commentList = [] %} #}

{% for comment in commentList %}
    <div class="comment-item">{{ comment }}</div>
{% empty %}
    <p>目前还没有任何评论。</p>
{% endfor %}

这种方法将“遍历”和“无内容提示”两种逻辑完美地整合在一起，使得代码结构更加紧凑和清晰。

方式三：直接在 if 语句中判断数组 与字符串一样，在安企CMS模板中，非空数组或切片会被视为“真值”（true），而空数组或切片则被视为“假值”（false）。因此，您也可以直接将它们作为 if 语句的条件。

{% set relatedArticles = [] %}
{# 或者 {% set relatedArticles = ["相关文章1"] %} #}

{% if relatedArticles %}
    <h3>相关推荐</h3>
    <ul>
    {% for article in relatedArticles %}
        <li>{{ article }}</li>
    {% endfor %}
    </ul>
{% else %}
    <p>暂无相关推荐。</p>
{% endif %}

3. 进阶使用：length_is 过滤器

除了仅仅判断是否为空，有时我们还需要判断数据的长度是否正好满足某个特定的要求。这时，length_is 过滤器就显得非常有用。它用于检查一个值（可以是字符串、数组等）的长度是否等于某个指定数字，并返回布尔值 True 或 False。

其语法为：

{{ 变量 | length_is: 目标长度 }}

例如，如果您需要确保某个导航菜单刚好有5个项目，就可以这样使用：

{% set navItems = ["首页", "产品", "服务", "关于我们", "联系我们"] %}
{# 或者 {% set navItems = ["首页", "产品"] %} #}

{% if navItems|length_is:5 %}
    <p>导航菜单刚好有5个项目，布局完美！</p>
{% else %}
    <p>导航菜单项目数量不符合预期。</p>
{% endif %}

结合 length_is:0 也可以实现判断为空的效果，但通常使用 length == 0 或直接 if 变量名更为常见。

总结

通过 length 过滤器及其相关的判断方法，安企CMS的用户可以在模板中更加灵活、精准地控制内容的展示逻辑。无论是简单的字符串或数组判空，还是更复杂的长度匹配，这些工具都能帮助您构建出用户体验更佳、逻辑更健壮的网站页面。理解并熟练运用这些过滤器，是提升安企CMS模板开发效率和质量的关键