Thymeleaf模板引擎超详细语法入门教程

引言

在Web开发中，模板引擎扮演着至关重要的角色，它使得前后端分离成为可能，同时让页面渲染更加灵活高效。Thymeleaf作为一种流行的Java模板引擎，以其强大的功能和友好的语法得到了广泛应用。本文将从零开始，带您逐步走进Thymeleaf的世界。

1. Thymeleaf概述

Thymeleaf是一个现代服务器端Java模板引擎，适用于Web和独立环境。它提供了一种优雅且强大的方式来创建任何文本（HTML、XML、邮件文本等）。Thymeleaf的主要目标是提供一种可被浏览器正确显示和解释的、同时也能够作为静态原型来工作的、并且可由服务端进行动态执行的模板创建方式。

2. 基本语法

2.1 变量表达式

在Thymeleaf中，使用${...}来表示变量表达式。例如，在HTML中，可以这样使用：

<p>当前用户名：${user.name}</p>

2.2 选择变量表达式

使用*{...}来选择变量。这通常在需要更复杂的表达式或方法调用时使用。例如：

<p>用户年龄：${#numbers.formatDecimal(user.age, 0, 'POINT', 0)}</p>

2.3 消息表达式

使用#{...}来表示消息表达式。这通常用于国际化。例如：

<p th:text="#{home.welcome}">欢迎访问首页</p>

2.4 链接URL表达式

使用@{...}来表示链接URL表达式。例如：

<a href="@{/order/process(orderId=${orderId})}">查看订单</a>

2.5 片段表达式

使用~{...}来表示片段表达式。这用于插入定义的片段。例如：

<div th:insert="~{commons :: main}"></div>

3. 条件语句

Thymeleaf支持条件语句，使用th:if或th:unless来实现。例如：

<div th:if="${user.admin}">
  <p>您是管理员</p>
</div>
<div th:unless="${user.admin}">
  <p>您不是管理员</p>
</div>

4. 循环语句

Thymeleaf也支持循环语句，使用th:each来实现。例如：

<ul>
  <li th:each="item : ${items}">
    <span th:text="${item.name}"></span>
  </li>
</ul>

5. 内联JavaScript

Thymeleaf允许在JavaScript中内联使用变量和表达式，这需要使用/*[[...]]*/语法。例如：

<script type="text/javascript">
  /*[[${someVariable}]]*/
</script>

6. 实际应用

在实际应用中，我们可以结合Spring框架来使用Thymeleaf。Spring提供了对Thymeleaf的集成支持，使得在Spring MVC项目中集成Thymeleaf变得非常简单。通过配置Thymeleaf视图解析器，我们可以直接在Controller中返回视图名称，Thymeleaf会自动将模型数据渲染到对应的模板中。

7. 总结

本文介绍了Thymeleaf模板引擎的基本语法和实际应用。通过学习和实践这些内容，您将能够轻松掌握Thymeleaf的使用方法，提高Web开发的效率和质量。希望本文对您有所帮助！