编辑“ThinkPHP-模板指南-Volist标签”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>导航：</strong>[[ThinkPHP-模板指南|返回上一页]]</span>
<div style="clear:both;"></div>
Volist标签主要用于在模板中循环输出数据集或者多维数组。

通常模型的select和findall方法返回的结果是一个二维数组，可以直接使用volist标签进行输出。在Action中首先对模版赋值：

'''[[PHP]]代码'''
<pre>
$User = M('User');    

$list = $User->select();    

$this->assign('list',$list);    
</pre>

在[[模板]]定义如下，循环输出用户的编号和姓名： 

'''[[XML]]/[[HTML]]代码'''
<pre>
<volist name="list" id="vo">   

{$vo.id}    

{$vo.name}    

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

'''例如'''：[[XML]]/[[HTML]]代码
<pre>
<volist name="list" id="data">   

{$data.id}    

{$data.name}    

</volist>   
</pre>

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

'''XML/HTML代码'''
<pre>
<volist name="list" id="vo" offset="5" length='10'>   

{$vo.name}    

</volist>   
</pre>

输出偶数记录 

'''XML/HTML代码'''
<pre>
<volist name="list" id="vo" mod="2" >   

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

</volist>   
</pre>
Mod属性还用于控制一定记录的换行.

'''例如'''：XML/HTML代码
<pre>
<volist name="list" id="vo" mod="5" >   

{$vo.name}    

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

</volist>   
</pre>

输出循环变量 

'''XML/HTML代码'''
<pre>
<volist name="list" id="vo" key="k" >   

{$k}.{$vo.name}    

</volist>   
</pre>
如果没有指定key属性的话，默认使用循环变量i.

'''例如'''：XML/HTML代码
<pre>
<volist name="list" id="vo"  >   

{$i}.{$vo.name}    

</volist>   
</pre>

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

'''例如'''：XML/HTML代码
<pre>
<volist name="list" id="vo"  >   

{$key}.{$vo.name}    

</volist>   
</pre>
volist还有一个别名iterate，用法和volist是一样。


[[category:ThinkPHP]]