ThinkPHP 模板引擎的 <volist> 標籤用於迴圈輸出資料集,常用屬性如下:
| 屬性 | 說明 |
|---|---|
| name | 必填,要輸出的模板變數名稱 |
| id | 必填,迴圈變數名稱 |
| offset | 可選,資料起始位移 |
| length | 可選,輸出資料長度 |
| key | 可選,迴圈鍵值變數,預設為 $i |
| mod | 可選,對 key 取模,預設為 2 |
| empty | 可選,資料為空時顯示的字串 |
與 Smarty 的 $smarty.foreach.name.last 不同,volist 沒有內建「是否為最後一筆」的屬性。但可以利用內建計數器 $i 搭配 count() 實現:
<volist name='lists' id='list'>
<li <if condition="$i eq count($lists)">class="last"</if>>
<a href="/tag/thinkphp">ThinkPHP 教程</a>
</li>
</volist>
$i 是 volist 內建的計數器,從 1 開始遞增,無需額外宣告。count($lists) 取得資料集總筆數。$i 等於總筆數時,即為最後一筆記錄。<volist name="list" id="vo">
<volist name="slist" id="s">
<if condition="$s.sid eq $vo['id']">
符合條件的內容。。。
</if>
</volist>
</volist>
此技巧常用於「分類下的文章列表」等巢狀資料渲染場景。