>[info] 循环标签 volist
<br/>
>[info] 基本属性
| 标签属性 | 别名 | 默认值 | 说明 |
| --- | --- | --- | --- | --- | --- |
| name| array | 必填 | 遍历的数组 |
| id | - | 必填 | 定义数据查询的结果存放变量名称
<br/>
>[info] volist 标签示例
在模版定义如下，循环输出用户的编号和姓名：
```
{volist name="list" id="vo"}
{$vo.id}:{$vo.name}<br/>
{/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语法，但可以支持变量输出，例如：
~~~
在公共头部加入变量
{php}
$empty = '<div class="no-empty">暂时没有数据</div>';
{/php}
~~~
然后在模板中使用：
~~~
{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}
~~~
