ThinkPHP Volist 標籤循環輸出完整教學

volist 是 ThinkPHP 模板引擎中用於遍歷數據集或多維陣列的核心標籤。本文系統講解基本用法、部分數據輸出、奇偶行控制、循環變量與數組索引輸出等進階技巧。

一、基本語法

<volist name="list" id="vo">
    用戶名：{$vo['username']}<br />
    電子郵件：{$vo['email']}<br />
    註冊時間：{$vo['regdate']|date="Y-m-d H:i",###}
</volist>

• name：模板賦值的變量名（如 $this->assign('list', $list)），不可隨意更改。
• id：循環變量名，可自定義，但不可與 name 衝突。

二、輸出部分數據

使用 offset（起始位置）與 length（條數）屬性：

<volist name="list" id="vo" offset="5" length="10">
    輸出第 5~14 條記錄
</volist>

三、奇偶行與模樣式控制

mod 屬性指定頻率，配合 eq 判斷標籤實現隔行變色或條件輸出：

1. 僅輸出偶數行

<volist name="list" id="vo" mod="2">
    <eq name="mod" value="0">
        {$vo['username']}<br />
    </eq>
</volist>

2. 表格隔行換色

<table>
<volist name="list" id="vo" mod="2">
    <tr<eq name="mod" value="0"> style="background:#FFF;"</eq>>
        <td>內容</td><td>內容</td>
    </tr>
</volist>
</table>

四、輸出循環序號

指定 key 屬性：

<volist name="list" id="vo" key="k">
    序號：{$k}<br />
    用戶名：{$vo['username']}
</volist>

五、輸出數組原始索引

直接使用 $key 變量（取決於數據本身的鍵名，而非循環順序）：

<volist name="list" id="vo">
    數組 key：{$key}<br />
    用戶名：{$vo['username']}
</volist>

六、提示

• key 輸出的是循環計數器（1,2,3...），$key 輸出的是數組實際鍵名。
• 多維陣列嵌套循環請參考《ThinkPHP Volist 標籤嵌套循環輸出多維陣列方法》。

更多 ThinkPHP 技術請參考專題：《ThinkPHP 入門教程》、《ThinkPHP 常用方法總結》、《Smarty 模板入門基礎教程》及《PHP 模板技術總結》。