在使用安企CMS（AnQiCMS）进行网站模板开发时，经常会遇到需要展示列表数据的情况，比如文章列表、产品列表或者图片集。当我们通过模板标签（例如 archiveList 或 categoryList）获取数据并使用 for 循环进行遍历时，如果列表是空的，通常需要给用户一个友好的提示，而不是显示一片空白。如何在 for 循环中优雅地判断列表是否为空并显示“暂无内容”的提示呢？AnQiCMS 模板引擎提供了非常简洁高效的解决方案。

AnQiCMS 模板中 for 循环与 empty 标签

AnQiCMS 的模板引擎语法类似于 Django 或 Blade，它支持 for 循环结构，同时也内置了一个 empty 标签，专门用于处理列表为空的场景。这意味着，您无需编写额外的 if 条件判断，可以直接在 for 循环内部处理空列表的显示逻辑，让代码更加清晰和易读。

其基本结构如下：

{% for item in yourList %}
    {# 这里是列表不为空时，遍历每个 item 的内容 #}
    <div>{{ item.Title }}</div>
{% empty %}
    {# 当 yourList 为空时，这里的内容会被显示 #}
    <p>抱歉，暂无内容可供展示。</p>
{% endfor %}

在这段代码中，yourList 代表您通过 AnQiCMS 模板标签获取到的数据列表，例如通过 {% archiveList archives with type="list" limit="10" %} 获得的 archives 变量。当 yourList 中有数据时，程序会进入 for 循环体，逐一处理 item 并显示相应的内容。而一旦 yourList 是一个空数组或空集合，for 循环体内的内容就会被跳过，转而执行 {% empty %} 标签内部的逻辑，显示“暂无内容”的提示。

详细解析与应用场景

这种 for...empty...endfor 的结构设计，极大地简化了模板代码。它将“有内容”和“无内容”两种情况的显示逻辑紧密地结合在一个结构中，避免了先用 if 判断列表长度，再分别编写 for 循环和空内容提示的冗余步骤。

例如，在一个展示最新文章的区块中，您可能希望在没有文章时显示“最新文章正在整理中，敬请期待”的字样。使用 empty 标签，您可以这样实现：

<div class="latest-articles">
    <h3>最新文章</h3>
    <ul>
    {% archiveList latestArticles with type="list" order="id desc" limit="5" %}
        {% for article in latestArticles %}
        <li>
            <a href="{{ article.Link }}">{{ article.Title }}</a>
            <span>{{ stampToDate(article.CreatedTime, "2006-01-02") }}</span>
        </li>
        {% empty %}
        <li>
            <p>最新文章正在整理中，敬请期待！</p>
        </li>
        {% endfor %}
    {% endarchiveList %}
    </ul>
</div>

在这个例子中，latestArticles 是通过 archiveList 标签获取的文章列表。如果数据库中没有符合条件的文章，latestArticles 变量将为空，模板会自动显示 {% empty %} 中的提示信息。这种方式不仅代码整洁，而且逻辑清晰，维护起来也更加方便。

同样，如果您在一个分类页面需要展示该分类下的所有文档，也可以利用此特性：

<div class="category-documents">
    <h2>{% categoryDetail with name="Title" %}下的文档</h2>
    <ul>
    {% archiveList categoryDocuments with type="page" categoryId=category.Id limit="10" %}
        {% for doc in categoryDocuments %}
        <li>
            <a href="{{ doc.Link }}">{{ doc.Title }}</a>
        </li>
        {% empty %}
        <li>
            <p>当前分类下暂无文档。</p>
        </li>
        {% endfor %}
    {% endarchiveList %}
    </div>
</div>

通过这种方式，无论 archiveList 标签返回的数据是空还是有内容，页面都能得到正确的渲染，从而提升用户体验。

总结

AnQiCMS 模板引擎中的 for...empty...endfor 结构是处理列表数据时一个非常实用的功能。它不仅让您的模板代码更加简洁、易于阅读，而且能够灵活地处理数据为空的场景，向访问者展示友好的提示信息。掌握这一技巧，能帮助您更高效地构建高质量的 AnQiCMS 网站模板。

常见问题 (FAQ)

  1. 问：empty 标签里的内容是否能访问 for 循环中的 item 变量？ 答：不能。{% empty %} 标签中的内容只在 for 循环的列表为空时执行，此时 item 变量并没有被定义，因此无法在 empty 块中访问 item 变量。您应该在 empty 块中放置通用的提示信息，而不是依赖列表中的具体数据。

  2. 问：除了 empty 标签，有没有其他方法来判断列表是否为空？ 答：当然有。您也可以使用 if 标签配合 length 过滤器来判断。例如：

    {% if yourList|length > 0 %}
    {% for item in yourList %}
        {# 列表内容 #}
    {% endfor %}
{% else %}
    <p>暂无内容。</p>
{% endif %}

    但通常情况下，for...empty...endfor 的结构更为推荐，因为它更加简洁，并将“有数据”和“无数据”的逻辑统一处理。

  3. 问：for 循环还有哪些其他常用的功能？ 答：for 循环除了 empty 标签外，还支持一些修饰符和内置变量，可以帮助您更灵活地控制循环行为：

    • reversed: 在 {% for item in yourList reversed %} 中使用，可以倒序遍历列表。
    • sorted: 在 {% for item in yourList sorted %} 中使用，可以对列表进行默认排序。
    • forloop 变量: 循环内部可以访问一个名为 forloop 的特殊变量，它提供了一些有用的信息，如 forloop.Counter（当前循环次数，从1开始）、forloop.Revcounter（当前循环剩余次数，从列表总数开始倒数）等，可以用于给列表项添加不同的样式或逻辑。