安企CMS#通用标签-for循环遍历标签#

for 遍历数组、slice等对象。

for用于循环访问数组中的每个项目，从而使该项目在上下文变量中可用。

示例代码

例如，要显示archiveList中提供的文档列表：

{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

还可以输出for循环的计数，以及剩余数量，还可以使用pluralize判断数量是否是复数。如：

{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">第{{ forloop.Counter }}篇，剩余{{ forloop.Revcounter}}篇，{{ forloop.Revcounter|pluralize:"多于1篇" }}：{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

for 还可以使用reversed翻转数组，sorted按int排序数组。如：

{% for item in archives reversed %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% for item in archives sorted %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% for item in archives reversed sorted %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

for还支持判断是否为空数组或者nil等，使用empty来输出不存在的情况。如:

{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% empty %}
<div>没有内容</div>
{% endfor %}

它等价于使用if判断，但是这样写可以更简洁：

{% if archives %}
{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% else %}
<div>没有内容</div>
{% endif %}

cycle 标签。在for循环中，我们还可以使用cycle标签，来循环逐个输出定义中的变量。

每次遇到此cycle标签时，都会产生其参数之一。 第一个参数在第一次遇到时产生，第二个参数在第二次遇到时产生，依此类推。 一旦所有参数用尽，标记将循环到第一个参数并再次产生它。

此标记在循环中特别有用。如：

{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        <h5 class="title">Title,Id 逐个出现：{% cycle item.Title item.Id %}</h5>
    </a>
</li>
{% endfor %}

或者使用as 来定义别名，再通过别名输出：

{% for item in archives %}
<li class="item">
    <a href="/archive/{{item.Id}}" class="link">
        {% cycle item.Title item.Id as cycleitem %}
        <h5 class="title">Title,Id 逐个出现：{{ cycleitem }}</h5>
    </a>
</li>
{% endfor %}