# Volist標簽 [上一頁](# "上一頁")[下一頁](# "下一頁") Volist標簽主要用于在模板中循環輸出數據集或者多維數組。 <table border="0" cellspacing="1" cellpadding="0"><tr><th colspan="2">volist標簽（循環輸出數據）</th> </tr><tr><td>閉合</td> <td>非閉合標簽</td> </tr><tr><td>屬性</td> <td><p>name（必須）：要輸出的數據模板變量</p><br/><p>id（必須）：循環變量</p><br/><p>offset（可選）：要輸出數據的offset</p><br/><p>length（可選）：輸出數據的長度</p><br/><p>key（可選）：循環的key變量，默認值為i</p><br/><p>mod（可選）：對key值取模，默認為2</p><br/><p>empty（可選）：如果數據為空顯示的字符串</p></td> </tr></table> 通常模型的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"?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>`從2.1版開始允許在模板中直接使用函數設定數據集，而不需要在控制器中給模板變量賦值傳入數據集變量，如： `<volist?name=":fun('arg')"?id="vo">{$vo.name}</volist>` [上一頁](# "上一頁")[下一頁](# "下一頁")