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>