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

通常模型的select和findall方法返回的结果是一个二维数组,可以直接使用volist标签进行输出。

在Action中首先对模版赋值:

PHP代码

代码片段
3 行
$User = M('User');   
$list = $User->select();   
$this->assign('list',$list);   

在模版定义如下,循环输出用户的编号和姓名:

XML/HTML代码

代码片段
4 行
<volist name="list" id="vo">  
{$vo.id}   
{$vo.name}   
</volist>  

Volist标签的name属性表示模板赋值的变量名称,因此不可随意在模板文件中改变。id表示当前的循环变量,可以随意指定,但确保不要和name属性冲突,例如:

XML/HTML代码

代码片段
4 行
<volist name="list" id="data">  
{$data.id}   
{$data.name}   
</volist>  

支持输出部分数据,例如输出其中的第5~15条记录

XML/HTML代码

代码片段
3 行
<volist name="list" id="vo" offset="5" length='10'>  
{$vo.name}   
</volist>  

输出偶数记录

XML/HTML代码

代码片段
3 行
<volist name="list" id="vo" mod="2" >  
<eq name="mod" value="1">{$vo.name}</eq>  
</volist>  

Mod属性还用于控制一定记录的换行,例如:

XML/HTML代码

代码片段
4 行
<volist name="list" id="vo" mod="5" >  
{$vo.name}   
<eq name="mod" value="4"><br/></eq>  
</volist>  

输出循环变量

XML/HTML代码

代码片段
3 行
<volist name="list" id="vo" key="k" >  
{$k}.{$vo.name}   
</volist>  

如果没有指定key属性的话,默认使用循环变量i,例如:

XML/HTML代码

代码片段
3 行
<volist name="list" id="vo"  >  
{$i}.{$vo.name}   
</volist>  

如果要输出数组的索引,可以直接使用key变量,和循环变量不同的是,这个key是由数据本身决定,而不是循环控制的,例如:

XML/HTML代码

代码片段
3 行
<volist name="list" id="vo"  >  
{$key}.{$vo.name}   
</volist>  

volist还有一个别名iterate,用法和volist是一样。