使用 Thymeleaf 动态渲染 HTML 标签名-html教程-PHP中文网

使用 Thymeleaf 动态渲染 HTML 标签名

霞舞

发布： 2025-09-09 20:31:01

原创

769人浏览过

使用 thymeleaf 动态渲染 html 标签名

本文介绍了如何在 Thymeleaf 模板中动态生成 HTML 标签名，根据模型属性值动态渲染 <h1> 到 <h6> 等标题标签。虽然可以使用 th:utext 实现，但推荐使用 Thymeleaf 片段（fragments）来提高代码可读性、可维护性，并降低安全风险。通过片段，可以更清晰地组织模板结构，避免直接在模板中嵌入未经转义的 HTML 代码。

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

在某些场景下，我们需要根据后端传递的模型数据，动态地渲染 HTML 标签。例如，根据文章的层级（level）动态生成 <h1> 到 <h6> 的标题标签。直接在模板中编写大量的 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. 引用片段

NameGPT名称生成器

免费AI公司名称生成器，AI在线生成企业名称，注册公司名称起名大全。

查看详情

在需要动态生成标签名的位置，使用 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 的值，动态生成了 <h3> 标签。