您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

ThinkPHP 模板循環標簽 volist 完整使用指南

編輯：PHP 綜合知識

項目結構調整

index.php 入口文件修改：
define('APP_PATH', 'myapp');  // 項目文件獨立目錄

模板 `index.html`

<html>
<head><title>{$title}</title></head>
<body>
{$content}<br>
<ul>
<volist name="list" id="news">
    <li>{$news.title}</li>
</volist>
</ul>
</body>
</html>

控制器邏輯

<?php
class IndexAction extends Action {
    public function index() {
        header("Content-Type:text/html; charset=utf-8");
        $this->assign('title', '循環標簽示例');
        $this->assign('content', 'volist 循環演示');
        
        // 構建測試數據（二維數組）
        $news = array(
            array('title' => 'Title1'),
            array('title' => 'Title2')
        );
        array_push($news, array('title' => 'Title3'));
        
        // 關鍵：模板 volist name="list" 對應此處 assign 'list'
        $this->assign('list', $news);
        $this->display();
    }
}
?>

輸出結果

<html>
<head><title>循環標簽示例</title></head>
<body>
volist 循環演示<br>
<ul>
<li>Title1</li><li>Title2</li><li>Title3</li>
</ul>
</body>
</html>

volist 核心屬性解析

屬性	說明	示例
`name`	數據源變量名（對應 assign 的鍵）	`name="list"`
`id`	循環變量別名（模板內引用）	`id="news"` → `{$news.title}`
`offset`	起始偏移（可選）	`offset="0"`
`length`	循環長度（可選）	`length="10"`
`key`	鍵名變量（可選）	`key="k"` → `{$k}`
`mod`	取模數（用於斑馬紋等）	`mod="2"`
`empty`	空數據時顯示內容	`empty="暫無數據"`

進階用法

{* 斑馬紋 *}
<volist name="list" id="vo" mod="2">
    <li class="<if condition='$i%2'>odd<else/>even</if>">{$vo.name}</li>
{/volist}

{* 巢狀循環 *}
<volist name="categories" id="cat">
    <h3>{$cat.name}</h3>
    <volist name="cat.items" id="item">
        <p>{$item.title}</p>
    </volist>
{/volist}

volist 以聲明式語法替代 PHP foreach，模板更純粹、設計師更友好。