Thymeleaf html语法
时间: 2025-05-23 14:17:20 浏览: 20
### Thymeleaf 中 HTML 语法的使用指南
Thymeleaf 是一种现代服务器端 Java 模板引擎,支持 Web 和独立环境下的开发。它允许开发者在标准 HTML 文件的基础上扩展功能,从而实现动态内容生成。
#### 声明 Thymeleaf 标识
为了使 HTML 文件能够被 Thymeleaf 解析,在文档头部需要添加特定命名空间声明 `xmlns:th`。这一步是必不可少的,因为只有这样 Thymeleaf 才能识别并解析文件中的自定义属性[^1]。
```html
<html xmlns:th="http://www.thymeleaf.org">
```
#### 动态文本设置 (`th:text`, `th:utext`)
Thymeleaf 提供了多种方式来动态替换 HTML 元素的内容。其中最常用的方式之一就是通过 `th:text` 属性指定变量表达式,用于替代静态文本内容。如果希望保留 HTML 标签而不转义,则可以使用 `th:utext` 来代替[^4]。
```html
<div th:text="${message}">默认显示文字</div>
<div th:utext="${contentWithHtmlTags}"></div>
```
#### 遍历集合数据 (`th:each`)
当需要展示列表型数据时,可以通过 `th:each` 实现循环遍历操作。该特性非常适合用来构建表格或者无序/有序列表等场景下重复渲染多个相似节点的情况[^4]。
```html
<table border="1">
<tr th:each="item : ${items}">
<td th:text="${item.name}">Item Name</td>
<td th:text="${item.price}">Price</td>
</tr>
</table>
```
#### URL 处理 (`@{...}`, `th:href`, `th:src`)
针对链接地址或资源路径的处理,建议采用 `${@{}}` 的形式书写相对路径,并配合相应的 HTML 属性如 `href` 或者 `src` 加上前缀 `th:` 来完成最终拼接工作[^2]。
```html
<a th:href="@{/product/details(id=${productId})}">Product Details</a>
<img th:src="@{/images/logo.png}" alt="Logo"/>
```
#### 放松 XML 要求 (可选)
从版本 3.0 开始,Thymeleaf 对于输入模板的要求变得更加灵活宽松,即使不完全遵循严格的 XML 结构也能正常运行程序逻辑[^5]。不过出于维护性和兼容性的考量,仍然鼓励按照传统 XML 方式编码。
---
### 总结
以上介绍了几个核心概念以及它们的实际应用场景,涵盖了从基础配置到高级特性的广泛范围。这些知识点构成了理解如何有效利用 Thymeleaf 构建强大而优雅的应用界面的基础框架。
阅读全文
相关推荐

















