volist 標簽用于在模板中循環輸出數據集或者多維數組。

volist 標簽

在模塊操作中，select() 方法返回的是一個二維數組,可以用 volist 直接輸出:

<volist name="list" id="vo">用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊時間：{$vo['regdate']|date="Y-m-d H:i",###}</volist>

如果想輸出多維數組,請參看《ThinkPHP 模板 Volist 標簽嵌套循環輸出多維數組》

注意:name的屬性值 list(name="list")不可隨意改變,需要與操作中的模板賦值指令對應:

$this->assign( "list", $list );

id 表示循環變量,可以隨意指定,但不得與 name 屬性沖突.

輸出部分數據

如果要輸出結果集中的部分數據,需要指定 offset(數據指針)與 length(數據數據條數)屬性.

輸出第 5~14 條記錄:

1. <volist name="list" id="vo" offset="5" length='10'>用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊時間：{$vo['regdate']|date="Y-m-d H:i",###}<hr /></volist> 

輸出奇/偶數記錄

volist 中的 mod 參數相當于指定一個頻率,系統會將當前的實際記錄對 mod 參數值求余(PHP中的%運算符)運算,而配合判斷標簽(如eq標簽),就可以按照頻率控制輸出的數據或數據顯示的格式.

例子1,輸出偶數記錄:

1. <volist name="list" id="vo" mod="2"><eq name="mod" value="0">用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊時間：{$vo['regdate']|date="Y-m-d H:i",###}<hr /></eq></volist> 

例子2,輸出所有記錄,但讓表格隔行顯示不同的背景顏色的例子:

1. <table><volist name="list" id="vo" mod="2"><tr<eq name="mod" value="0"> style="background-color:#FFF;"</eq>> <td>我是單元格內容</td> <td>我也是單元格內容</td></tr></volist></table> 

提示:實際使用中可以靈活設定 mod 參數的值,而不僅僅限于奇偶.

輸出循環變量

指定 key 屬性用于輸出循環的變量次數(注意不是數據表主鍵 id):

1. <volist name="list" id="vo" key="k">序 號：{$k}<br />用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊時間：{$vo['regdate']|date="Y-m-d H:i",###}<hr /></volist> 

輸出數組索引

直接使用 $key 變量用于輸出數組索引:

1. <volist name="list" id="vo">數組key：{$key}<br />用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊時間：{$vo['regdate']|date="Y-m-d H:i",###}<hr /></volist> 

提示:與輸出循環變量不同的是,這個 key 值取決于數據本身,而不是 volist 循環輸出決定的.