volist标签

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

volist(name,id,offset,length,key,mod,empty)

name(必须):要输出的数据模型变量

id(必须):循环变量

offset(可选):要输出数据的offset

length(可选):输出数据的长度

key(可选):循环的key变量,默认值为i

mod(可选):对key值取模,默认为2(用于偶数行查询等)

empty(可选):如果数据为空显示的字符串

通常模型的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>