在网站内容管理中，动态地展示列表数据是一项非常基础且重要的功能。无论是新闻列表、产品展示、分类导航，还是友情链接，都需要我们能够灵活地从后台获取数据并在前端模板上呈现。安企CMS（AnQiCMS）提供了强大且易用的模板引擎，让我们可以轻松实现这些需求，其中“for循环”便是实现列表数据展示的核心工具。
AnQiCMS的模板引擎采用了类似Django的语法风格，这使得有网页开发经验的用户能够快速上手。当我们谈论“for循环”时，它允许我们逐一遍历后台传递到前端的数组或集合数据，并对每一项进行独立的处理和展示。
开启数据遍历之旅：for循环的基础用法
最常见的for循环形式，就是像这样：{% for item in your_list %}。在这里，your_list代表的是你从后台获取到的列表数据，而item则是一个临时变量，它在每一次循环中都会自动指向your_list中的当前一项数据。当循环结束时，我们需要用{% endfor %}来闭合这个循环块。
例如，如果我们有一个名为archives的文章列表数据，想要在网页上显示它们的标题和链接，我们可以这样编写模板代码：
<ul>
{% for article in archives %}
<li><a href="{{ article.Link }}">{{ article.Title }}</a></li>
{% endfor %}
</ul>
在这个例子中，article就是我们在循环中自定义的item变量，通过article.Link和article.Title，我们就能分别获取到每篇文章的链接和标题，从而动态生成列表。
此外，为了让您更好地控制列表的显示，for循环还提供了一些实用的内置变量，它们都可以在forloop对象中找到：
forloop.Counter：表示当前循环的迭代次数，从1开始计数。forloop.Revcounter：表示当前循环剩余的迭代次数。
利用这些计数器，我们可以轻松地为列表中的第一项或最后一项添加特殊的样式，或者进行其他逻辑判断。
灵活应对：for循环的进阶运用
在实际应用中，列表数据的展示往往不是一成不变的，AnQiCMS的for循环提供了多种修饰符和标签来应对不同的场景。
处理空数据：{% empty %}标签
有时，您从后台获取的数据列表可能是空的。如果直接循环一个空列表，页面上就什么都不会显示，这可能会让访问者感到困惑。为了提供更友好的用户体验，for循环支持{% empty %}标签。当for循环遍历的列表为空时，{% empty %}区块中的内容就会被显示出来，而不是循环本身。
<ul>
{% for product in products %}
<li>
<img src="{{ product.Thumb }}" alt="{{ product.Title }}">
<h3>{{ product.Title }}</h3>
</li>
{% empty %}
<li>抱歉，暂时没有产品信息可供显示。</li>
{% endfor %}
</ul>
改变循环顺序：reversed和sorted修饰符
您可能需要以倒序显示列表，或者对列表项进行简单的排序。AnQiCMS的for循环支持reversed和sorted修饰符：
{% for item in list reversed %}：将列表倒序遍历。{% for item in list sorted %}：将列表进行默认排序后遍历（通常是对数字或字符串的字典序）。
例如，要显示最新发布的文章在列表顶部，但后台数据是按ID升序存储的，您可以使用reversed：
{% for news in news_list reversed %}
<p>{{ news.Title }} - {{ stampToDate(news.CreatedTime, "2006-01-02") }}</p>
{% endfor %}
实现交替样式：cycle标签
在某些设计中，您可能需要列表项呈现交替的样式，比如奇数行和偶数行颜色不同。cycle标签为此提供了完美的解决方案。它允许您定义一系列值，每次循环都会按顺序取出并使用一个值，直到所有值用尽后再从头开始。
{% for item in my_items %}
<div class="{% cycle 'even-row' 'odd-row' %}">
{{ item.Content }}
</div>
{% endfor %}
这样，my_items列表中的第一项会使用even-row类，第二项使用odd-row，第三项再次使用even-row，以此类推。
结合AnQiCMS内置标签的实际应用
AnQiCMS内置了众多实用的标签来帮助您获取各种类型的数据列表，然后您就可以结合for循环来展示它们。
展示文章列表（archiveList）
archiveList标签是用于获取文章或文档列表的强大工具。您可以根据分类ID、模块ID、推荐属性、排序方式等多种条件来筛选和获取数据。
<h3>最新文章</h3>
<ul>
{% archiveList latest_articles with type="list" limit="5" order="id desc" %}
{% for article in latest_articles %}
<li>
<a href="{{ article.Link }}">{{ article.Title }}</a>
<span>发布于：{{ stampToDate(article.CreatedTime, "2006-01-02") }}</span>
<span>阅读量：{{ article.Views }}</span>
</li>
{% empty %}
<li>暂无最新文章。</li>
{% endfor %}
{% endarchiveList %}
</ul>
展示分类列表（categoryList）
如果您需要构建导航菜单或侧边栏分类，categoryList标签配合for循环会非常方便。它甚至支持多级分类的嵌套循环展示。
<nav>
<ul class="main-nav">
{% categoryList top_categories with moduleId="1" parentId="0" %} {# 获取文章模块的顶级分类 #}
{% for category in top_categories %}
<li class="nav-item">
<a href="{{ category.Link }}">{{ category.Title }}</a>
{% if category.HasChildren %} {# 判断是否有子分类 #}
<ul class="sub-nav">
{% categoryList sub_categories with parentId=category.Id %} {# 获取当前分类的子分类 #}
{% for sub_category in sub_categories %}
<li><a href="{{ sub_category.Link }}">{{ sub_category.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
</ul>
{% endif %}
</li>
{% endfor %}
{% endcategoryList %}
</ul>
</nav>
展示友情链接（linkList）
对于网站底部的友情链接，linkList标签可以直接获取后台配置的链接数据，然后通过for循环呈现。
<div class="friend-links">
<h4>友情链接</h4>
{% linkList friends %}
{% if friends %}
<ul>
{% for link in friends %}
<li><a href="{{ link.Link }}" {% if link.Nofollow == 1 %}rel="nofollow"{% endif %} target="_blank">{{ link.Title }}</a></li>
{% endfor %}
</ul>
{% else %}
<p>暂无友情链接。</p>
{% endif %}
{% endlinkList %}
</div>
图片处理注意事项
在循环展示列表项时，特别是涉及到图片，您可能会遇到图片地址或缩略图的问题。AnQiCMS的archiveList或categoryList等标签返回的item对象通常会包含item.Thumb或item.Logo这样的属性，它们直接提供了图片路径。如果需要对图片进行额外的处理，例如获取缩略图或使用延迟加载，您可能需要配合其他过滤器或HTML属性，例如lazy="data-src"来设置图片的延迟加载属性。
保持模板整洁高效：**实践
在模板开发中，良好的习惯能大大提高效率和代码的可维护性。
- 合理命名变量： 在
for循环中，为item选择一个有意义的名称（例如article、category），能让代码更具可读性。 - 利用
|safe过滤器： 如果您循环输出的内容中包含HTML代码（比如文章内容字段），为了避免HTML标签被转义成纯文本，记得使用|safe过滤器，例如{{ article.Content|safe }}。 - 优化模板结构： 对于重复使用的代码块，考虑使用
{% include "partial/header.html" %}等辅助标签将其抽离成独立的文件，然后在需要的地方引入，这能让您的模板结构更清晰，更易于维护。 - 性能考量： 尽管AnQiCMS的模板标签已经做了很多优化，但在设计复杂的
for循环和嵌套时，仍应注意避免不必要的重复数据查询，保持逻辑简洁。
通过熟练运用for循环及其丰富的进阶用法，结合AnQiCMS内置的各类数据列表标签，您将能够高效、灵活地在模板中展示各种动态内容，构建出功能强大且界面美观的网站。
常见问题 (FAQ)
在
for循环中，如何判断当前循环项是列表中的第一项或最后一项？ 您可以使用forloop对象提供的内置变量来判断。forloop.Counter == 1可以判断是否为第一项，而forloop.Revcounter == 0（或者判断forloop.Last，虽然文档中未明确提及，但通常类似引擎会有）则可以判断是否为最后一项。例如：{% if forloop.Counter == 1 %}这是列表的第一项{% endif %}。我如何在
for循环中显示图片，并确保它们是正确的缩略图？ AnQiCMS的大多数列表标签（如archiveList、categoryList）返回的item对象通常会包含Thumb（缩略图）或Logo（封面图）等字段。您可以直接使用这些字段的值作为<img>标签