当前位置：首页 > 文章列表 > 文章 > 前端 > Thymeleaf动态渲染HTML技巧分享

Thymeleaf动态渲染HTML技巧分享

2025-09-25 20:27:32 0浏览收藏

本文深入探讨了Thymeleaf模板引擎中动态渲染HTML标签的实用技巧，尤其针对需要根据后端数据动态生成

到

等标题标签的场景。虽然`th:utext`属性可以实现此功能，但存在可读性差、安全风险和维护性低等问题。因此，文章强烈推荐使用Thymeleaf片段（fragments）来优雅地解决这一问题。通过定义和引用片段，可以清晰地组织模板结构，避免直接嵌入未经转义的HTML代码，从而提高代码的可读性、可维护性，并有效降低跨站脚本攻击（XSS）的安全风险。本文将提供详细的代码示例，帮助开发者掌握Thymeleaf片段在动态HTML标签生成中的应用，提升Web开发的效率和安全性。
本文介绍了如何在 Thymeleaf 模板中动态生成 HTML 标签名，根据模型属性值动态渲染

到

等标题标签。虽然可以使用 th:utext 实现，但推荐使用 Thymeleaf 片段（fragments）来提高代码可读性、可维护性，并降低安全风险。通过片段，可以更清晰地组织模板结构，避免直接在模板中嵌入未经转义的 HTML 代码。

动态生成标签名的需求场景

在某些场景下，我们需要根据后端传递的模型数据，动态地渲染 HTML 标签。例如，根据文章的层级（level）动态生成

到

的标题标签。直接在模板中编写大量的 th:if 条件判断虽然可行，但代码冗余且难以维护。

使用 th:utext 实现动态标签名（不推荐）

Thymeleaf 提供了 th:utext 属性，允许输出未经转义的 HTML 代码。我们可以利用字符串拼接的方式，动态生成标签名。

<th:block th:utext="|<h${model.level}>${model.title}</t${model.level}>|">

这种方法虽然可以实现需求，但是存在以下问题：

可读性差： 模板代码难以阅读和理解。
安全性风险： 如果 model.title 包含用户输入，可能会导致跨站脚本攻击（XSS）。
维护性差： 修改和调试代码比较困难。

因此，不推荐使用 th:utext 来动态生成标签名。

使用 Thymeleaf 片段（Fragments）实现动态标签名（推荐）

Thymeleaf 片段是一种更优雅、更安全、更易于维护的解决方案。我们可以将动态标签名的逻辑封装在一个片段中，然后在模板中引用该片段。

1. 定义片段

在模板中定义一个名为 title 的片段，该片段接受 level 和 title 两个参数。

<th:block th:fragment="title(level, title)">
  <h1 th:text="${title}" th:if="${level == 1}"></h1>
  <h2 th:text="${title}" th:if="${level == 2}"></h2>
  <h3 th:text="${title}" th:if="${level == 3}"></h1>
  <h4 th:text="${title}" th:if="${level == 4}"></h1>
  <h5 th:text="${title}" th:if="${level == 5}"></h1>
  <h6 th:text="${title}" th:if="${level == 6}"></h1>
</th:block>

2. 引用片段

在需要动态生成标签名的位置，使用 th:replace 属性引用该片段，并传递 level 和 title 参数。

<th:block th:replace="index :: title(level=${model.level}, title=${model.title})" />

其中，index 是包含片段的模板文件名（不包含后缀），title 是片段的名称。

完整示例

假设我们有一个名为 index.html 的模板文件，包含以下内容：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Thymeleaf 动态标签名示例</title>
</head>
<body>

<th:block th:replace="index :: title(level=${model.level}, title=${model.title})" />

<th:block th:fragment="title(level, title)">
    <h1 th:text="${title}" th:if="${level == 1}"></h1>
    <h2 th:text="${title}" th:if="${level == 2}"></h2>
    <h3 th:text="${title}" th:if="${level == 3}"></h3>
    <h4 th:text="${title}" th:if="${level == 4}"></h3>
    <h5 th:text="${title}" th:if="${level == 5}"></h3>
    <h6 th:text="${title}" th:if="${level == 6}"></h3>
</th:block>

</body>
</html>

在 Spring Boot 控制器中，我们可以传递一个包含 level 和 title 属性的模型对象：

@Controller
public class MyController {

    @GetMapping("/index")
    public String index(Model model) {
        model.addAttribute("model", new MyModel(3, "我的标题"));
        return "index";
    }

    static class MyModel {
        private int level;
        private String title;

        public MyModel(int level, String title) {
            this.level = level;
            this.title = title;
        }

        public int getLevel() {
            return level;
        }

        public String getTitle() {
            return title;
        }
    }
}

访问 /index 路径，将会生成以下 HTML 代码：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Thymeleaf 动态标签名示例</title>
</head>
<body>

<h3>我的标题</h3>

</body>
</html>

可以看到，Thymeleaf 根据 model.level 的值，动态生成了