本教程旨在帮助开发者掌握如何在Spring Boot应用中，利用Thymeleaf模板引擎高效渲染包含列表数据的HTML表格，并为每行数据集成独立的操作按钮，例如删除功能。文章详细讲解了从后端数据模型的设计、控制器的数据准备，到前端Thymeleaf模板的迭代渲染和表单提交的整个过程。重点解决Thymeleaf表格渲染中常见的循环嵌套错误，确保每个数据行对应唯一的按钮，从而提高代码清晰度和可维护性。通过统一数据模型，将相关信息封装在单一Java对象中，简化前端遍历逻辑。结合实际案例，演示如何在Thymeleaf中正确遍历列表，为每行数据添加独立操作按钮，避免不必要的重复渲染，最终构建出结构清晰、功能完善的Web页面。

引言：Thymeleaf 表格渲染与交互的挑战

在Web应用开发中，展示列表数据并为每条数据提供独立的操作（如编辑、删除）是常见需求。Spring Boot结合Thymeleaf提供了一种简洁高效的解决方案。然而，开发者在使用Thymeleaf迭代渲染表格时，尤其是在处理每行数据对应的操作按钮时，常会遇到循环嵌套不当导致重复渲染按钮的问题。本教程旨在通过一个实际案例，演示如何正确地在Thymeleaf中遍历列表，并在表格的每一行中为对应的数据项添加一个独立的操作按钮，避免不必要的重复。

核心概念：统一数据模型

为了在表格中正确地展示一行数据的所有相关信息（例如，一个用户的ID、邮箱以及其对应的操作），最佳实践是将这些相关属性封装在一个单一的Java对象中。这样做不仅能使数据结构更清晰，也能极大地简化前端Thymeleaf的遍历逻辑。

示例：用户数据模型

假设我们需要展示用户列表，每行包含用户的ID和邮箱。我们可以定义一个 User 类来封装这些信息：

public class User {
    private Long id;
    private String email;
    // 可以添加其他需要的字段，例如用户名、描述等

    // 构造函数
    public User(Long id, String email) {
        this.id = id;
        this.email = email;
    }

    // Getter 和 Setter 方法
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    // 可以重写 toString, equals, hashCode 方法以便调试
}

后端控制器：数据准备

在Spring Boot的控制器中，我们需要准备一个包含 User 对象的列表，并将其添加到 Model 中，以便Thymeleaf模板可以访问到这些数据。

示例：Spring Controller 代码片段

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import java.util.ArrayList;
import java.util.List;

@Controller
public class UserController {

    @GetMapping("/users")
    public String listUsers(Model model) {
        // 模拟从数据库获取用户列表
        List specialUsers = new ArrayList<>();
        specialUsers.add(new User(1L, "alice@example.com"));
        specialUsers.add(new User(2L, "bob@example.com"));
        specialUsers.add(new User(3L, "charlie@example.com"));

        // 将用户列表添加到模型中，键名为 "specialUsers"
        model.addAttribute("specialUsers", specialUsers);
        return "userList"; // 返回 Thymeleaf 模板的名称
    }

    // 假设有一个处理删除请求的方法
    // @PostMapping("/user/delete")
    // public String deleteUser(@RequestParam("id") Long userId) {
    //     // 执行删除逻辑
    //     System.out.println("Deleting user with ID: " + userId);
    //     return "redirect:/users";
    // }
}

前端模板：Thymeleaf 表格渲染与操作

现在，我们将在Thymeleaf模板中渲染这个用户列表。关键在于将 th:each 循环正确地放置在 标签上，这样每次迭代都会生成一个完整的表格行，包含所有相关数据和其对应的操作按钮。

示例：userList.html Thymeleaf 模板

    
    
    


    
用户管理

    

        

            

                
ID
                
邮箱
                
操作
            
        
        

            
            

                

                

                

                    

                        
                        <input type="hidden" name="id" th:value="${user.id}">
                        删除
                    
                
            
        
    

代码解析：

1. 和 ： 良好的表格结构实践，区分表头和表体。
2. th:each="user : ${specialUsers}"： 这是核心。th:each 直接作用于 标签。这意味着对于 specialUsers 列表中的每一个 User 对象，Thymeleaf 都会生成一个全新的 标签及其内部的所有 元素。
3. th:text="${user.id}" 和 th:text="${user.email}"： 在循环内部，我们可以通过 user 对象访问当前行的属性（如 id 和 email），并将其渲染到对应的 中。
4. 操作按钮的表单：
   • 内部包含一个
     标签。这个表单是为当前行的用户定制的。
   • th:action="@{/user/delete}" 定义了表单提交的目标URL。@{/user/delete} 是Thymeleaf的URL表达式，会自动处理上下文路径。
   • <input type="hidden" name="id" th:value="${user.id}">：这是一个关键点。我们使用一个隐藏的输入字段来传递当前 user 的 id。当用户点击“删除”按钮并提交表单时，这个 id 会作为请求参数发送到后端控制器，后端可以根据这个 id 执行删除操作。
   • 删除：提交表单的按钮。

常见问题与最佳实践

• 错误循环位置： 初学者常犯的错误是将 th:each 放在 上，或者为不同的列（如 description 和 id）分别进行 th:each 循环。这会导致：
  • 如果 th:each 在 上，该 会被重复渲染多次。
  • 如果为不同的列表分别循环，且这些列表长度不一致或不对应，则会导致数据错位或重复渲染。
  • 正确做法： 始终将 th:each 放在 上，以确保每次迭代生成一个完整的、逻辑上独立的数据行。
• 统一数据结构： 避免使用多个独立的列表（如 descriptionList 和 idList）来表示同一行数据的不同部分。这使得数据管理和模板渲染变得复杂且容易出错。
  • 正确做法： 设计一个封装所有相关属性的Java对象（如 User），然后创建一个该对象的列表。
• 表单与数据传递： 当需要为列表中的每个项目提供操作按钮时，通常会结合 标签。确保使用隐藏字段 (<input type="hidden">) 来传递当前行的唯一标识符（如 id），以便后端能够识别并处理正确的项目。
• Thymeleaf 表达式： 熟练使用 th:text (设置元素的文本内容)、th:value (设置表单元素的 value 属性) 和 th:action="@{/path}" (设置表单的 action URL) 等Thymeleaf标准表达式。

总结

通过本教程，我们学习了如何在Spring Boot应用中使用Thymeleaf模板引擎，正确地渲染包含列表数据的HTML表格，并为每行数据集成独立的操作按钮。关键在于：

1. 设计统一的数据模型：将一行中的所有相关数据封装到一个Java对象中。
2. 后端控制器准备数据：将这些对象的列表添加到 Model 中。
3. 前端Thymeleaf正确迭代：将 th:each 属性放置在 标签上，确保每次循环生成一个完整的表格行。
4. 嵌入表单传递数据：在每行的操作 中嵌入一个表单，并使用隐藏字段传递当前数据项的唯一标识符。

遵循这些实践，可以有效地避免常见的循环渲染问题，构建出结构清晰、功能完善且易于维护的Web页面。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~