本文介绍了如何在 Thymeleaf 模板中动态生成 HTML 标签名，根据模型属性值动态渲染

到

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

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

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

到

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

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

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

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

立即学习“前端免费学习笔记（深入）”；

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

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

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

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

1. 定义片段

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

2. 引用片段

传媒公司模板(RTCMS)1.0

传媒企业网站系统使用热腾CMS(RTCMS),根据网站板块定制的栏目，如果修改栏目，需要修改模板相应的标签。站点内容均可在后台网站基本设置中添加。全站可生成HTML，安装默认动态浏览。并可以独立设置SEO标题、关键字、描述信息。源码包中带有少量测试数据，安装时可选择演示安装或全新安装。如果全新安装，后台内容充实后，首页才能完全显示出来。（全新安装后可以删除演示数据用到的图片，目录在https://

下载

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

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

完整示例

假设我们有一个名为 index.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 代码：

    
    



我的标题

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

标签。

总结

使用 Thymeleaf 片段可以更优雅、更安全地实现动态标签名。这种方法不仅提高了代码的可读性和可维护性，还降低了安全风险。在实际开发中，建议优先使用 Thymeleaf 片段来处理动态标签名的需求。