# Volist标签 [上一页](# "上一页")[下一页](# "下一页") Volist标签主要用于在模板中循环输出数据集或者多维数组。 <table border="0" cellspacing="1" cellpadding="0"><tr><th colspan="2">volist标签（循环输出数据）</th> </tr><tr><td>闭合</td> <td>非闭合标签</td> </tr><tr><td>属性</td> <td><p>name（必须）：要输出的数据模板变量</p><br/><p>id（必须）：循环变量</p><br/><p>offset（可选）：要输出数据的offset</p><br/><p>length（可选）：输出数据的长度</p><br/><p>key（可选）：循环的key变量，默认值为i</p><br/><p>mod（可选）：对key值取模，默认为2</p><br/><p>empty（可选）：如果数据为空显示的字符串</p></td> </tr></table> 通常模型的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" empty="暂时没有数据" > {$vo.id}|{$vo.name} </volist>`empty属性不支持直接传入html语法，但可以支持变量输出，例如：`$this->assign('empty','<span class="empty">没有数据</span>'); $this->assign('list',$list);`然后在模板中使用：`<volist name="list" id="vo" empty="$empty" > {$vo.id}|{$vo.name} </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>`从2.1版开始允许在模板中直接使用函数设定数据集，而不需要在控制器中给模板变量赋值传入数据集变量，如： `<volist name=":fun('arg')" id="vo">{$vo.name}</volist>` [上一页](# "上一页")[下一页](# "下一页")