在安企CMS（AnQiCMS）的模板开发中，我们经常需要遍历文档列表，例如通过 archiveList 标签获取的内容。在这样的 for 循环中，了解当前列表的总长度是一个非常实用的需求，它能帮助我们实现一些特定的展示逻辑，比如显示“第N篇/共M篇”或者判断列表是否为空。
安企CMS的模板引擎借鉴了Django的语法，它提供了一套直观而强大的标签和过滤器来处理数据。要获取 for 循环中 archives 文档列表的总长度，我们可以巧妙地利用模板引擎提供的过滤器功能。
核心概念：列表数据与过滤器
在AnQiCMS的模板中，通过 archiveList 等标签获取到的 archives 通常是一个数组（或Go语言中的slice）类型的对象。模板引擎为这类数组对象提供了一个名为 length 的过滤器，可以直接计算其包含的元素数量。
length 过滤器的工作原理很简单：它接收一个字符串、数组或键值对，并返回其包含的元素个数。对于数组或列表而言，它会返回元素的总数量。
如何获取 archives 的总长度
最直接且推荐的方式是在 for 循环开始之前，就利用 length 过滤器计算出 archives 列表的总长度，并将其存储在一个新的变量中。
使用
archiveList获取文档列表： 首先，你需要使用archiveList标签来获取你的文档列表。例如，我们获取一个包含10篇文章的列表：{% archiveList archives with type="list" limit="10" %} {# 接下来我们会在这个区域处理 archives 列表 #} {% endarchiveList %}在循环外获取总长度并赋值给变量： 在
for循环遍历archives之前，我们可以直接对archives这个变量应用length过滤器。为了在后续的模板中使用这个总长度值，我们通常会配合set标签将其赋值给一个新的变量，例如total_count。{% archiveList archives with type="list" limit="10" %} {% set total_count = archives|length %} {# 使用 length 过滤器获取总长度并赋值给 total_count #} {# ... 后续的 for 循环和展示逻辑 ... #} {% endarchiveList %}这里的
archives|length就会计算出archives列表中实际的文档数量。在
for循环中利用总长度： 获取到总长度total_count后，你就可以在for循环的内部灵活使用它了。例如，结合forloop.Counter（当前循环的索引，从1开始）来展示当前文档在总列表中的位置：{% archiveList archives with type="list" limit="10" %} {% set total_count = archives|length %} <p>本批次文章共 <strong>{{ total_count }}</strong> 篇。</p> <ul> {% for item in archives %} <li> <a href="{{ item.Link }}">{{ item.Title }}</a> <span> (第 {{ forloop.Counter }} 篇 / 共 {{ total_count }} 篇)</span> </li> {% empty %} <li>当前分类或条件下暂无文章。</li> {% endfor %} </ul> {% endarchiveList %}
完整示例代码
下面是一个结合了获取文档列表、计算总长度并在循环中使用的完整示例：
{# 假设这是一个文章列表页，我们想展示该分类下的文章及其总数 #}
{% archiveList articles with type="list" categoryId="1" limit="20" %} {# 获取 ID 为 1 的分类下最多 20 篇文章 #}
{% set total_articles_count = articles|length %} {# 计算文章列表的总长度 #}
{% if total_articles_count > 0 %} {# 判断列表是否为空 #}
<h2>最新文章 (共 {{ total_articles_count }} 篇)</h2>
<div class="article-list">
{% for article in articles %}
<div class="article-item">
<h3><a href="{{ article.Link }}">{{ article.Title }}</a></h3>
<p class="meta">
发布时间：{{ stampToDate(article.CreatedTime, "2006-01-02") }}
浏览量：{{ article.Views }}
(第 {{ forloop.Counter }} 篇)
</p>
<p>{{ article.Description }}</p>
{% if article.Thumb %}
<img src="{{ article.Thumb }}" alt="{{ article.Title }}" class="article-thumb">
{% endif %}
</div>
{% endfor %}
</div>
{% else %}
<p>抱歉，当前分类下没有找到任何文章。</p>
{% endif %}
{% endarchiveList %}
通过这种方式，您可以轻松地在安企CMS模板中的 for 循环中获取文档列表的总长度，并根据实际需求进行灵活的展示和逻辑处理。这种做法既符合模板引擎的设计哲学，也保证了代码的清晰和可维护性。
常见问题 (FAQ)
Q1: 如果 archives 列表为空，archives|length 会返回什么？
A1: 如果 archives 列表为空，archives|length 将会返回 0。您可以利用这个特性，结合 if 语句（如示例中的 {% if total_articles_count > 0 %}）来判断列表是否有内容，从而显示不同的提示信息，比如“暂无内容”。
Q2: forloop.Counter 和 archives|length 有什么区别？
A2: forloop.Counter 是一个在 for 循环内部使用的特殊变量，它代表 当前 循环迭代的次数，从 1 开始递增。而 archives|length 则是通过对整个 archives 列表应用 length 过滤器得到的 总 元素数量，它在整个循环周期内保持不变。简单来说，forloop.Counter 是当前位置，archives|length 是总长度。
Q3: 除了 archives，我能用 length 过滤器获取其他变量的长度吗？
A3: 是的，length 过滤器不仅适用于通过 archiveList 获取的 archives 列表，它还可以用于任何数组（slice）、字符串或键值对（map）类型的变量。例如，你可以用 {{ "Hello World"|length }} 获取字符串长度，或者用 {{ my_custom_array|length }} 获取自定义数组的长度。