volist 循環標簽 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# volist 循環標簽 ## 循環標簽用于循環輸出數組或者對象的屬性，例如使用多文件、多圖片、復選、鍵值對的組件時，在內容頁調用該標簽循環輸出內容。 ## 格式示例 ``` <pre class="calibre16">``` {hkcms:volist name="Info.images"} <div class="carousel-item {$currentstyle}"> <img src="{$item}" class="d-block w-100"> </div> {/hkcms:volist} ``` ``` ## 參數參數名稱可選值默認值是否必填說明currentstyle-active-指定選中的class樣式具體看下面示例current-1-指定第幾個選中，默認active class給到第一個id-$item-指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title}name---傳入數組、對象offset---從第幾條開始循環length---循環次數，例如輸出其中的第5～15條記錄，offset="5" length='10'mod---取余運算empty---為空的時候輸出提示key-i-指定循環變量，如果沒有指定key屬性的話，默認使用循環變量i## 參數說明 `currentstyle` 屬性，用于圖集數組在輪播圖時進來頁面看到的第一張圖片，active 沒有定義樣式，需要自己定義。結合`current`屬性，current=1，在第一次循環時currentstyle等于active，其他循環為空。如下： ``` <pre class="calibre16">``` // current=2，只有循環到第二次時$currentstyle變量才有active值 {hkcms:volist name="$Info.more.files" current="2"} <p class="{$currentstyle}">{$item}</p> {/hkcms:volist} ``` ``` `id` 屬性，用于改變循環變量，默認是$item，例如改成$vo，無需加$ ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" id="vo" } <p>{$vo}</p> {/hkcms:volist} ``` ``` `name` 屬性，傳入要輸出的變量名稱，如上面，取的是自己添加的字段files（多文件數組類型）。除了變量，還支持調用方法如下： ``` <pre class="calibre16">``` {hkcms:volist name=":ceshi()" id="vo"} <p>{php}dump($vo);{/php}</p> {/hkcms:volist} ``` ``` `offset` 屬性，用于限制從第幾條開始循環，例如如下：結合`length`屬性輸出其中的第5～15條記錄 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" offset="5" length="10"} <p>{php}dump($item);{/php}</p> {/hkcms:volist} ``` ``` `mod`取余運算屬性，使用該屬性后，在循環模板里面得到{$mod}變量，里面的值等于循環變量`i%mod`，i是從1開始的，每循環一次i+1。例如：mod="2"，判斷偶數奇數。用于每一行圖片左右擺放樣式不一樣時可以使用。更多使用方式根據實際情況設置。 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" mod="2"} {$i} - {$mod} {if $mod==1}偶數{else /}奇數{/if} {/hkcms:volist} ``` ``` `empty`為空提示標簽，不支持傳入HTML，但可以傳入變量 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" empty="沒有更多數據了"} {php}dump($item){/php} {/hkcms:volist} ``` ``` 傳入變量 ``` <pre class="calibre16">``` {php}$empty = '- 沒有更多數據了 -';{/php} {hkcms:volist name="$Info.more.files" empty="$empty"} {php}dump($item){/php} {/hkcms:volist} ``` ``` `key` 循環變量屬性，默認是i，從1開始，每循環一次增加1。輸出循環變量 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" } {php}dump($i){/php} {/hkcms:volist} ``` ``` 改變循環變量 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" key="k" } {php}dump($k){/php} {/hkcms:volist} ``` ``` 循環變量不是指數組索引值，數組索引值可以使用{$key}。 ``` <pre class="calibre16">``` {hkcms:volist name="$Info.more.files" } {$key} {/hkcms:volist} ``` ``` ## 示例 - 設置第二張選中，選中的class 為：ac 有時候，我們的圖集輪播圖，需要默認顯示第幾張顯示，可按一下設置參數，設置好后，將{$currentstyle}放入你想放入的class標簽上即可。 ``` <pre class="calibre20">``` // Info.images 為內容里的圖集，name不用加：$，可參考模板開發下的可用變量。 {hkcms:volist name="Info.images" currentstyle="ac" current="2"} <div class="carousel-item {$currentstyle}"> <img src="{$item}" class="d-block w-100"> </div> {/hkcms:volist} ``` ```