php

Volist标签

2023-10-09

模板引擎支持标签的多层嵌套功能,可以对标签库的标签指定可以嵌套。

系统内置的标签中,volist(及其别名iterate)、switch、if、elseif、else、foreach、compare(包括所有的比较标签)、(not)present、(not)empty、(not)defined等标签都可以嵌套使用。

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

volist.png

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


在Action中首先对模版赋值:

$User = M('User');

$list = $User->select();

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


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

<volist name="list" id="vo">

   {$vo.id}

   {$vo.name}

</volist>


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

<volist name="list" id="data">

   {$data.id}

   {$data.name}

</volist>


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

<volist name="list" id="vo" offset="5" length='10'>

   {$vo.name}

</volist>


 输出偶数记录

<volist name="list" id="vo" mod="2" >

   <eq name="mod" value="1">{$vo.name}</eq>

</volist>


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

<volist name="list" id="vo" mod="5" >

   {$vo.name}

   <eq name="mod" value="4"><br/></eq>

</volist>


 输出循环变量

<volist name="list" id="vo" key="k" >

   {$k}.{$vo.name}

</volist>


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

<volist name="list" id="vo"  >

   {$i}.{$vo.name}

</volist>


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

<volist name="list" id="vo"  >

   {$key}.{$vo.name}

</volist>


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

从2.1版开始允许使用函数设定数据集,如:

<volist name=":fun('arg')" id="vo">{$vo.name}</volist>