循環標簽 · CMSPRO

## `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; } ~~~