功能:循環內容
格式:
{%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