循环标签
最后更新于：2022-04-02 01:53:20
## `FOREACH`标签
`foreach`标签的用法和PHP语法非常接近，用于循环输出数组或者对象的属性，用法如下：
~~~
$list = User::all();
$this->assign('list',$list);
~~~
模板文件中可以这样输出
~~~
{foreach $list as $key=>$vo }
{$vo.id}:{$vo.name}
{/foreach}
~~~
可以不通过模板变量赋值，支持使用函数或者方法获取数据循环输出：
~~~
{foreach :model('user')->all() as $key=>$vo }
{$vo.id}:{$vo.name}
{/foreach}
~~~
## `VOLIST`标签
`volist`标签通常用于查询数据集或者二维数组的结果输出。 在控制器中首先对模版赋值：
~~~
$list = User::all();
$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} ~~~ 可以直接使用函数设定数据集，而不需要在控制器中给模板变量赋值传入数据集变量，如： ~~~ {volist name=":model('user')->all()" id="vo"} {$vo.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"}
{/eq} {/volist} ~~~ 为空的时候输出提示： ~~~ {volist name="list" id="vo" empty="暂时没有数据" } {$vo.id}|{$vo.name} {/volist} ~~~ `empty`属性不支持直接传入html语法，但可以支持变量输出，例如： ~~~ $this->assign('empty','没有数据'); $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} ~~~ ## `FOR`标签 用法： ~~~ {for start="开始值" end="结束值" comparison="" step="步进值" name="循环变量名" } {/for} ~~~ 开始值、结束值、步进值和循环变量都可以支持变量，开始值和结束值是必须，其他是可选。comparison 的默认值是lt，name的默认值是i，步进值的默认值是1，举例如下： ~~~ {for start="1" end="100"} {$i} {/for} ~~~ 解析后的代码是 ~~~ for ($i=1;$i<100;$i+=1){ echo $i; } ~~~
';
{/volist} ~~~ `Volist`标签的`name`属性表示模板赋值的变量名称，因此不可随意在模板文件中改变。`id`表示当前的循环变量，可以随意指定，但确保不要和`name`属性冲突，例如： ~~~ {volist name="list" id="data"} {$data.id}:{$data.name}
{/volist} ~~~ 可以直接使用函数设定数据集，而不需要在控制器中给模板变量赋值传入数据集变量，如： ~~~ {volist name=":model('user')->all()" id="vo"} {$vo.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"}
{/eq} {/volist} ~~~ 为空的时候输出提示： ~~~ {volist name="list" id="vo" empty="暂时没有数据" } {$vo.id}|{$vo.name} {/volist} ~~~ `empty`属性不支持直接传入html语法，但可以支持变量输出，例如： ~~~ $this->assign('empty','没有数据'); $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} ~~~ ## `FOR`标签 用法： ~~~ {for start="开始值" end="结束值" comparison="" step="步进值" name="循环变量名" } {/for} ~~~ 开始值、结束值、步进值和循环变量都可以支持变量，开始值和结束值是必须，其他是可选。comparison 的默认值是lt，name的默认值是i，步进值的默认值是1，举例如下： ~~~ {for start="1" end="100"} {$i} {/for} ~~~ 解析后的代码是 ~~~ for ($i=1;$i<100;$i+=1){ echo $i; } ~~~