TP5 volist

VOLIST標簽

volist標簽通常用於查詢數據集（select方法）的結果輸出，通常模型的select方法返回的結果是一個二維數組，可以直接使用volist標簽進行輸出。 在控制器中首先對模版賦值：

$list = User::all(); $this->assign('list',$list); 

在模版定義如下，循環輸出用戶的編號和姓名：

{volist name="list" id="vo"} {$vo.id}:{$vo.name}<br/> {/volist} 

Volist標簽的name屬性表示模板賦值的變量名稱，因此不可隨意在模板文件中改變。id表示當前的循環變量，可以隨意指定，但確保不要和name屬性沖突，例如：

{volist name="list" id="data"} {$data.id}:{$data.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語法，但可以支持變量輸出，例如：

$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} 

模板中可以直接使用函數設定數據集，而不需要在控制器中給模板變量賦值傳入數據集變量，如：

{volist name=":fun('arg')" id="vo"} {$vo.name} {/volist} 

FOREACH標簽

foreach標簽類似與volist標簽，只是更加簡單，沒有太多額外的屬性，最簡單的用法是：

{foreach $list as $vo} 
    {$vo.id}:{$vo.name}
{/foreach}

該用法解析后是最簡潔的。

也可以使用下面的用法：

{foreach name="list" item="vo"} {$vo.id}:{$vo.name} {/foreach} 

name表示數據源 item表示循環變量。

可以輸出索引，如下：

{foreach name="list" item="vo" } {$key}|{$vo} {/foreach} 

也可以定義索引的變量名

{foreach name="list" item="vo" key="k" } {$k}|{$vo} {/foreach} 

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; }