Volist標簽主要用於在模板中循環輸出數據集或者多維數組。
volist標簽(循環輸出數據) |
|
閉合 |
非閉合標簽 |
屬性 |
name(必須):要輸出的數據模板變量 id(必須):循環變量 offset(可選):要輸出數據的offset length(可選):輸出數據的長度 key(可選):循環的key變量,默認值為i mod(可選):對key值取模,默認為2 empty(可選):如果數據為空顯示的字符串 |
通常模型的select方法返回的結果是一個二維數組,可以直接使用volist標簽進行輸出。
在Action中首先對模版賦值:
$User = M('User');
$list = $User->select();
$this->assign('list',$list);
在模版定義如下,循環輸出用戶的編號和姓名:
<volist name="list" id="vo">
{$vo.id}
{$vo.name}
</volist>
Volist標簽的name屬性表示模板賦值的變量名稱,因此不可隨意在模板文件中改變。id表示當前的循環變量,可以隨意指定,但確保不要和name屬性沖突,例如:
<volist name="list" id="data">
{$data.id}
{$data.name}
</volist>
支持輸出部分數據,例如輸出其中的第5~15條記錄
<volist name="list" id="vo" offset="5" length='10'>
{$vo.name}
</volist>
輸出偶數記錄
<volist name="list" id="vo" mod="2" >
<eq name="mod" value="1">{$vo.name}</eq>
</volist>
Mod屬性還用於控制一定記錄的換行,例如:
<volist name="list" id="vo" mod="5" >
{$vo.name}
<eq name="mod" value="4"><br/></eq>
</volist>
輸出循環變量
<volist name="list" id="vo" key="k" >
{$k}.{$vo.name}
</volist>
如果沒有指定key屬性的話,默認使用循環變量i,例如:
<volist name="list" id="vo" >
{$i}.{$vo.name}
</volist>
如果要輸出數組的索引,可以直接使用key變量,和循環變量不同的是,這個key是由數據本身決定,而不是循環控制的,例如:
<volist name="list" id="vo" >
{$key}.{$vo.name}
</volist>
volist還有一個別名iterate,用法和volist是一樣。
從2.1版開始允許使用函數設定數據集,如:
<volist name=":fun('arg')" id="vo">{$vo.name}</volist>