ThinkPHP8模板引擎怎么用？volist标签如何循环输出？-ThinkPHP-PHP中文网

thinkphp8模板引擎使用volist标签循环输出数据时，核心做法是通过assign方法将数组或对象集合传递给视图，然后在模板中使用{volist}标签指定name属性为变量名、id属性为遍历项别名。该标签支持自定义循环次数、起始索引和空数据提示，能够高效处理列表渲染。

ThinkPHP8模板引擎怎么用？volist标签如何循环输出？

volist标签的基本语法结构是怎样的

volist标签的完整语法包含名称、标识符、数量、偏移量、键名和空值处理等参数。其中name必须对应控制器传入的变量，id用于在循环体内引用当前元素，key可选用于获取当前索引或键名。若需限制输出条数，可设置length；若需跳过前几条，可设置offset。当数据为空时，通过empty属性显示占位文本。

ThinkPHP8模板引擎怎么用？volist标签如何循环输出？

<?php namespace app\controller;
use think\App;

class Index
{
    public function index()
    {
        $data = [
            ['id' => 1, 'name' => 'Alice'],
            ['id' => 2, 'name' => 'Bob'],
            ['id' => 3, 'name' => 'Charlie']
        ];
        return view('index', ['list' => $data]);
    }
}
?>

预期结果：控制器成功将$data数组以list键名传递给视图层，视图可通过{volist name="list" id="item"}进行遍历。

volist标签如何处理分页与条件过滤

在实际项目中，volist常配合分页逻辑或前端条件判断使用。虽然volist本身不支持SQL级过滤，但可在控制器中先对数据进行筛选再传入视图。例如使用array_filter或模型查询条件预处理数据。此外，结合mod属性可实现隔行换色等样式控制，而empty属性则确保无数据时页面不出现空白区域。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

ThinkPHP8模板引擎怎么用？volist标签如何循环输出？

<?php // 控制器中预处理数据
$filteredData = array_filter($data, function($item) {
    return $item['id'] > 1;
});
return view('index', ['list' => $filteredData]);
?>

预期结果：仅id大于1的记录被传入视图，volist循环仅输出Bob和Charlie两条数据。