th:each

th:each 是 Thymeleaf 模板引擎中的一个迭代标签，用于在 HTML 页面中循环遍历集合或数组，并对每个元素执行相应的操作。Thymeleaf 是一个 Java 模板引擎，广泛应用于 Web 开发中，特别是在 Spring Boot 项目中。

基础概念

th:each 标签允许你在 HTML 中嵌入循环逻辑，它可以遍历任何实现了 Iterable 接口的对象，如列表（List）、集合（Set）或数组。它的基本语法如下：

<div th:each="item, iterStat : ${collection}">
    <!-- 使用 item 变量访问当前迭代的元素 -->
    <!-- iterStat 是一个迭代状态对象，提供了额外的信息，如当前索引、是否为第一个或最后一个元素等 -->
</div>

优势

简洁性：th:each 提供了一种简洁的方式来遍历集合，避免了在控制器中编写复杂的逻辑。
可读性：通过在 HTML 中直接展示迭代逻辑，代码更加直观易懂。
灵活性：可以与 Thymeleaf 的其他表达式和属性结合使用，实现更复杂的页面渲染需求。

类型

th:each 主要有两种使用方式：

简单迭代：仅遍历集合中的元素。
带状态迭代：除了遍历元素外，还提供了一个迭代状态对象（iterStat），该对象包含当前迭代的索引、是否为第一个或最后一个元素等信息。

应用场景

列表渲染：在电商网站中显示商品列表。
表格数据填充：在后台管理系统中展示数据库记录。
动态表单生成：根据用户输入的数量动态生成表单项。

示例代码

假设我们有一个包含用户信息的列表，我们想要在页面上显示每个用户的姓名和邮箱：

// 控制器中的代码
@GetMapping("/users")
public String listUsers(Model model) {
    List<User> users = userService.getAllUsers();
    model.addAttribute("users", users);
    return "user-list";
}

<!-- user-list.html -->
<table>
    <thead>
        <tr>
            <th>姓名</th>
            <th>邮箱</th>
        </tr>
    </thead>
    <tbody>
        <tr th:each="user, iterStat : ${users}">
            <td th:text="${user.name}"></td>
            <td th:text="${user.email}"></td>
        </tr>
    </tbody>
</table>