帮助文档
forlist标签语法说明
功能:循环内容
格式:
{%forlist from=$循环变量标签 key=循环标识 max=输出数量%}
循环内容
{%/forlist%}
参数说明:
form:必填,输出的循环变量标签,请查看各个输出循环变量标签说明;
key:必填,循环输出标识,必须为英文字符;
max:可选,输出数量。因内容调用输出大部分使用模板片段调用功能,且都可以通过指定显示数量来实现,因此该参数极少使用。请填写大于0的整数,如未填写,则按默认循环数量进行显示;
字段显示方法:
{%key=>循环标识%}:当前内容的循环数,从1开始累加;
{%list=>循环标识%}:当前内容的循环数,从0开始累加
{%$循环变量标签[循环标识].字段%}:内容字段输出;
{%div=>循环标识=N%} 显示要素 {%/div=>循环标识%}:当显示N条后执行“显示要素”内容,常用于一行多列循环显示;
特别提醒:
1、forlist只能用于列表内容的输出,不能用于单条内容的输出;
2、如果定义了max参数,但实际输出的数字小于max的时候,则forlist仍然输出相应max数量的内容;
3、Key=>标识和list=>标识,都可以用于判断
实例一:循环输出内容列表
{%forlist from=$array key=i max=3%}
{%key=>i%}:{%$array[i].title%}
{%/forlist%}
输出结果:
1:标题一
2:标题二
3:标题三
实例二:循环输出内容列表,每2列加一条水平线,循环输出6条内容
{%forlist from=$array key=i max=6%}
{%key=>i%}:{%$array[i].title%}
{%div=>i=2%}
{%/div=>i%}
{%/forlist%}
输出结果:
1:标题一
2:标题二
3:标题三
4:标题四
5:标题五
6:标题6