Thymeleaf `each`迭代器与`a`标签的巧妙结合：详解循环渲染链接126

Thymeleaf 是一款优秀的现代服务器端 Java 模板引擎，它能够在浏览器端显示数据并提供优雅的模板处理方式。 其中，`th:each` 属性用于迭代集合数据，而 `


```

这段代码会生成一个无序列表，其中每个列表项都是一个链接。`th:each="link : ${links}"` 迭代 `links` 列表中的每个元素，并将每个元素赋值给 `link` 变量。`th:href="${}"` 设置链接的 URL，`th:text="${}"` 设置链接的文本。

处理更复杂的集合：Map 和对象

除了简单的列表，`th:each` 也能处理更复杂的集合，例如 `Map` 和自定义对象。假设我们有一个包含用户对象的列表：```java
class User {
String name;
String profileUrl;
// ... constructor and getters/setters ...
}
List users = (
new User("John Doe", "/john"),
new User("Jane Smith", "/jane")
);
("users", users);
```

在 Thymeleaf 模板中，我们可以这样生成用户资料链接：```html





```

这里使用了 Thymeleaf 的 `@{}` 语法来构建相对路径，确保链接正确。

状态变量和迭代索引

`th:each` 提供了状态变量，可以访问迭代的索引和计数。例如，`*` 表示当前迭代的索引（从 0 开始），`index` 表示当前迭代的索引（从 1 开始），`count` 表示当前迭代的计数，`size` 表示集合的大小，`even/odd` 表示当前迭代是偶数还是奇数。```html






```

这段代码会在每个链接前显示索引号。

处理空集合

如果集合为空，`th:each` 不会产生任何输出。为了避免这种情况，可以使用 `th:if` 进行条件判断：```html

No users found.




```

避免常见错误

使用 `th:each` 和 `` 标签时，需要注意以下几点：
确保集合数据正确传递到模板中。
正确使用表达式语法，例如 `th:href` 和 `th:text`。
避免在循环内部使用相同的 id 属性，这可能会导致 JavaScript 错误。
对于 URL，最好使用 Thymeleaf 的 `@{}` 语法来构建相对路径，确保链接的正确性。

Thymeleaf 的 `th:each` 属性结合 `` 标签，提供了一种高效且优雅的方式来动态生成链接。通过掌握本文介绍的各种技巧和最佳实践，你可以轻松处理各种类型的集合数据，并创建出功能强大的动态网页。

熟练掌握 `th:each` 与 `` 标签的结合使用，能够极大地提升你的 Thymeleaf 模板开发效率，并创建更灵活、更易维护的动态网页应用。

2025-04-12

上一篇：Java后端使用Post请求发送JSON数据到短链接服务

下一篇：深度解析中国移动A3开机优化技巧及常见问题