通常volist標簽多用於查詢數據集(select方法)的結果輸出,通常模型的select方法返回的結果是一個二維數組,對此可以直接使用volist標簽進行輸出。
在控制器中首先對模版賦值,如下例所示:
$User = M('User'); $list = $User->limit(10)->select(); $this->assign('list',$list);
在模版定義如下,循環輸出用戶的編號和姓名:
<volist name="list" id="vo"> {$vo.id}:{$vo.name}<br/> </volist>
Volist標簽的name屬性表示模板賦值的變量名稱,因此不可隨意在模板文件中改變。id表示當前的循環變量,可以隨意指定,但需要確保不要和name屬性沖突,例如:
<volist name="list" id="data"> {$data.id}:{$data.name}<br/> </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" empty="暫時沒有數據" > {$vo.id}|{$vo.name} </volist>
empty屬性不支持直接傳入html語法,但可以支持變量輸出,例如:
$this->assign('empty','<span class="empty">沒有數據</span>'); $this->assign('list',$list);
然後在模板中使用:
<volist name="list" id="vo" empty="$empty" > {$vo.id}|{$vo.name} </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 name=":fun('arg')" id="vo"> {$vo.name} </volist>