volist標簽通常用於查詢數據集(select方法)的結果輸出,通常模型的select方法返回的結果是一個二維數組,可以直接使用volist標簽進行輸出。
屬性:
- name(必須):輸出的數據變量
- id(必須):循環變量,一般為vo
- offset(可選):要輸出數據的offset,偏移量
- length(可選):輸出數據的長度
- key(可選):循環的key變量,默認值為i
- mod(可選):對key值取模,默認為2
- empty(可選):如果數據為空顯示的字符串
數據為空時的提示
<volist name="list" id="vo" empty="暫時沒有數據" >
{$vo.id}|{$vo.name}
</volist>
empty屬性不支持直接傳入html語法,但可以支持變量輸出,例如:
$this->assign('empty','<span class="empty">沒有數據</span>');
但為了代碼的可讀性,不建議將過分復雜的數據為空的HTML語法寫在控制層。
輸出循環變量
<volist name="list" id="vo" key="k" >
{$k}.{$vo.name}
</volist>
如果不寫,默認為 $i
,是循環變量從1開始。
輸出數組的索引
可以直接使用key變量,和循環變量不同的是,這個key是由數據本身決定,而不是循環控制的,例如:
<volist name="list" id="vo" >
{$key}.{$vo.name}
</volist>
這個好像沒法自定義,而且不支持輸出關聯數組鍵值。