通用标签-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 %}