巧用AnQiCMS模板，轻松获取循环中的“第一”与“第N”个索引

在网站内容运营中，我们经常需要在页面上展示一系列内容，比如文章列表、产品展示、导航菜单等。为了更好地呈现这些内容，我们常常需要对列表中的每个项目进行精细化控制，例如给第一个项目添加特殊样式，或者为每个项目显示其在列表中的序号。对于使用AnQiCMS的朋友们来说，了解如何在模板的for循环中获取当前迭代项的索引，是一项非常实用且能极大提升模板灵活性的技能。

AnQiCMS采用了类似Django的模板引擎语法，这使得内容开发者可以非常便捷地构建动态页面。在处理列表数据时，我们通常会使用for循环标签来遍历数据集合。而要在循环中获取每个元素的序号，AnQiCMS提供了一个内置的特殊变量，让这个需求变得轻而易举。

认识forloop.Counter：你的1-based循环计数器

当你在AnQiCMS模板中使用{% for item in collection %}这样的结构来遍历一个列表（例如文章集合、分类列表或图片组）时，模板引擎会悄然为你提供一个名为forloop的特殊变量。这个forloop变量包含了与当前循环状态相关的诸多实用信息，其中最核心的，便是我们今天的主角——forloop.Counter。

forloop.Counter顾名思义，是一个计数器。它的独特之处在于，它从1开始计数。这意味着，当循环第一次运行时，forloop.Counter的值是1；第二次是2，以此类推，直到循环结束。这对于需要从1开始为列表项编号的场景非常方便。

让我们看一个简单的例子，假设我们正在展示一个产品列表，并希望为每个产品显示其序号：

{% archiveList products with type="list" limit="5" %}
    {% for product in products %}
    <div class="product-item">
        <span class="product-number">{{ forloop.Counter }}.</span>
        <h3><a href="{{ product.Link }}">{{ product.Title }}</a></h3>
        <p>{{ product.Description }}</p>
    </div>
    {% endfor %}
{% endarchiveList %}

在这段代码中，{{ forloop.Counter }}会分别为列表中的第一个产品显示“1.”，第二个产品显示“2.”，以此类推。这种直观的1-based计数方式，完美契合了人类的阅读习惯和很多业务逻辑需求。

掌握forloop.Revcounter：从“尾巴”数起的倒序索引

除了正向计数，AnQiCMS还为我们提供了forloop.Revcounter这个变量。与forloop.Counter相反，forloop.Revcounter提供的是一个倒序的、同样从1开始计数的索引。这意味着，列表中的最后一个项目，它的forloop.Revcounter值是1；倒数第二个是2，直到列表的第一个项目，它的forloop.Revcounter值等于列表的总长度。

forloop.Revcounter在某些特定场景下能发挥奇效，比如你需要对列表中的最后几个项目进行特殊处理，或者以倒序的形式显示序号。

结合这两个计数器，我们可以构建更复杂的逻辑：

{% categoryList categories with moduleId="1" parentId="0" %}
    {% for category in categories %}
    <li class="category-item {% if forloop.Counter == 1 %}first{% endif %} {% if forloop.Revcounter == 1 %}last{% endif %}">
        <span class="index">{{ forloop.Counter }}</span>. 
        <a href="{{ category.Link }}">{{ category.Title }}</a>
        <span class="remaining-items">（还有{{ forloop.Revcounter - 1 }}个）</span>
    </li>
    {% empty %}
    <li>暂无分类。</li>
    {% endfor %}
{% endcategoryList %}

在这个例子中，我们不仅为每个分类添加了正向序号，还利用forloop.Counter == 1为第一个元素添加了first类，利用forloop.Revcounter == 1为最后一个元素添加了last类。同时，forloop.Revcounter - 1则巧妙地展示了当前项后面还有多少个元素。

实用场景与技巧

forloop.Counter和forloop.Revcounter这两个变量在实际开发中非常有用：

  1. 序号显示：最常见的用途就是为列表项添加序号，如“1. 标题A”、“2. 标题B”等。
  2. 条件样式：你可以根据forloop.Counter或forloop.Revcounter的值来为特定位置的元素添加不同的CSS类，例如给列表的第一个、最后一个或者每隔N个元素添加特殊样式。这在tag-bannerList.md和tag-archiveList.md的示例中也有体现，比如{% if forloop.Counter == 1 %}active{% endif %}。
  3. 唯一ID生成：结合其他变量，可以生成页面上唯一的ID，方便JavaScript操作或锚点链接。
  4. 循环跳出/限制：虽然forloop.Counter本身不直接控制循环，但你可以结合if语句，在达到某个计数时进行特殊处理或中断逻辑。
  5. 空数据处理：值得一提的是，AnQiCMS的for循环还支持{% empty %}标签，当遍历的集合为空时，会执行empty块中的内容，此时forloop变量自然也就不存在了。

通过灵活运用forloop.Counter和forloop.Revcounter，AnQiCMS的内容运营者和模板开发者可以轻松实现各种复杂的列表展示和交互逻辑，让网站内容更加生动、有条理。

常见问题 (FAQ)

Q1: AnQiCMS的for循环中，forloop.Counter提供的索引是从0开始还是从1开始？

A1: AnQiCMS的forloop.Counter提供的是一个从1开始计数的索引。这意味着列表的第一个元素其forloop.Counter的值是1，第二个是2，以此类推。如果你需要0-based的索引，可以简单地使用{{ forloop.Counter - 1 }}来实现。

Q2: 除了正向索引，我能否获取列表项的倒序索引？

A2: 当然可以。AnQiCMS在for循环中还提供了forloop.Revcounter变量，它能为你提供当前迭代项在列表中的倒序索引，同样是从1开始计数。例如，列表中的最后一个元素的forloop.Revcounter值是1，倒数第二个是2。

Q3: 如果我需要对列表中的第一个或最后一个项目应用特殊样式，应该怎么做？

A3: 你可以使用forloop.Counter和forloop.Revcounter结合if条件判断来实现。例如，为第一个项目添加样式，可以使用{% if forloop.Counter == 1 %}；为最后一个项目添加样式，可以使用{% if forloop.Revcounter == 1 %}。这样可以非常精准地控制特定位置元素的表现。