volist 標(biāo)簽用于在模板中循環(huán)輸出數(shù)據(jù)集或者多維數(shù)組。

volist 標(biāo)簽

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

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

如果想輸出多維數(shù)組,請(qǐng)參看《ThinkPHP 模板 Volist 標(biāo)簽嵌套循環(huán)輸出多維數(shù)組》

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

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

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

輸出部分?jǐn)?shù)據(jù)

如果要輸出結(jié)果集中的部分?jǐn)?shù)據(jù),需要指定 offset(數(shù)據(jù)指針)與 length(數(shù)據(jù)數(shù)據(jù)條數(shù))屬性.

輸出第 5~14 條記錄:

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

輸出奇/偶數(shù)記錄

volist 中的 mod 參數(shù)相當(dāng)于指定一個(gè)頻率,系統(tǒng)會(huì)將當(dāng)前的實(shí)際記錄對(duì) mod 參數(shù)值求余(PHP中的%運(yùn)算符)運(yùn)算,而配合判斷標(biāo)簽(如eq標(biāo)簽),就可以按照頻率控制輸出的數(shù)據(jù)或數(shù)據(jù)顯示的格式.

例子1,輸出偶數(shù)記錄:

1. <volist name="list" id="vo" mod="2"><eq name="mod" value="0">用 戶 名：{$vo['username']}<br />電子郵件：{$vo['email']}<br />注冊(cè)時(shí)間：{$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>我是單元格內(nèi)容</td> <td>我也是單元格內(nèi)容</td></tr></volist></table> 

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

輸出循環(huán)變量

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

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

輸出數(shù)組索引

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

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

提示:與輸出循環(huán)變量不同的是,這個(gè) key 值取決于數(shù)據(jù)本身,而不是 volist 循環(huán)輸出決定的.