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

volist 標簽

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

1. <volist?name="list"?id="vo">?
2. 用?戶?名：{$vo['username']}<br?/>?
3. 電子郵件：{$vo['email']}<br?/>?
4. 注冊時間：{$vo['regdate']|date="Y-m-d?H:i",###}?
5. </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'>?
2. 用?戶?名：{$vo['username']}<br?/>?
3. 電子郵件：{$vo['email']}<br?/>?
4. 注冊時間：{$vo['regdate']|date="Y-m-d?H:i",###}?
5. <hr?/>?
6. </volist>

輸出奇/偶數記錄

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

例子1，輸出偶數記錄：

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

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

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

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

輸出循環變量

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

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

輸出數組索引

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

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