volist 标签用于在模板中循环输出数据集或者多维数组。

volist 标签

在模块操作中，select() 方法返回的是一个二维数组,可以用 volist 直接输出:

用 户 名：{$vo['username']}
电子邮件：{$vo['email']}
注册时间：{$vo['regdate']|date="Y-m-d H:i",###}

如果想输出多维数组,请参看《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 循环输出决定的.