foreach 语句使用说明

简单示例

{{#foreach list}}
  <a href='{{url}}'>{{title}}</a>
{{/foreach}}

变量

在数据循环内部会有一组数据变量可以使用：

{{@index}} (number) - 数组的下标

{{@number}} (number) - 推荐数字的自然数

{{@key}} (string) - 当调用数据为对象时，可以得到对象的 key

{{@first}} (boolean) - 第一条数据

{{@last}} (boolean) - 最后一条数据

{{@odd}} (boolean) - 根据下标判断当前数据是否为奇数

{{@even}} (boolean) - 根据下标判断当前数据是否为奇数

{{@rowStart}} (boolean) - 列开始（如果定义了列数）

{{@rowEnd}} (boolean) - 列奇数（如果定义了列数）

使用

else 和数据为 false 时

{{#foreach list}}
  <a href='{{url}}'>{{title}}</a>
{{else}}
  <p>没有链接</p>
{{/foreach}}

limit 条数限制属性

通过此属性循环出指定条目数量

{{#foreach list limit="5"}}
  <a href='{{url}}'>{{title}}</a>
{{/foreach}}

from 和 to 属性

通过此属性只循环出从 from 开始 to 结束的下标的条目

{{#foreach list from="2" to="3"}}
  <a href='{{url}}'>{{title}}</a>
{{/foreach}}

columns 属性

配合 rowStart 和 rowEnd 变量根据指定栏数进行分栏显示

{{#foreach posts columns="3"}}
  <section class="{{post_class}}{{#if @rowStart}} row-start{{/if}}{{#if @rowEnd}} row-end{{/if}}">
    <h2>{{title}}</h2>
    <p>{{excerpt</p>
  </section>
{{/foreach}}