原文地址：https://dwz.cn/2UR4feq8
作者：yizhiwazi

学习目标

快速掌握Thymeleaf的基本使用（五大基础语法+常用内置对象）

使用教程

温馨提示：Thymeleaf 最为显著的特征是增强属性，任何属性都可以通过th:xx 来完成交互，例如th:value最终会覆盖value属性。

一、基础语法

变量表达式 ${}

使用方法：直接使用th:xx = "${}" 获取对象属性。例如：

选择变量表达式 *{}

使用方法：首先通过th:object 获取对象，然后使用th:xx = "*{}"获取对象属性。

这种简写风格极为清爽，推荐大家在实际项目中使用。例如：

链接表达式 @{}

使用方法：通过链接表达式@{}直接拿到应用路径，然后拼接静态资源路径。例如：

<script th:src="@{/webjars/jquery/jquery.js}"></script>

片段表达式 ~{}

片段表达式是Thymeleaf的特色之一，细粒度可以达到标签级别，这是JSP无法做到的。

片段表达式拥有三种语法：

~{ viewName } 表示引入完整页面
~{ viewName ::selector} 表示在指定页面寻找片段其中selector可为片段名、jquery选择器等
~{ ::selector} 表示在当前页寻找

使用方法：首先通过th:fragment定制片段，然后通过th:replace 填写片段路径和片段名。例如：


 <script th:src="@{/webjars/jquery/3.3.1/jquery.js}"></script>

在实际使用中，我们往往使用更简洁的表达，去掉表达式外壳直接填写片段名。例如：

值得注意的是，使用替换路径th:replace 开头请勿添加斜杠，避免部署运行的时候出现路径报错。（因为默认拼接的路径为spring.thymeleaf.prefix = classpath:/templates/）

消息表达式

即通常的国际化属性：#{msg} 用于获取国际化语言翻译值。例如：

其它表达式

在基础语法中，默认支持字符串连接、数学运算、布尔逻辑和三目运算等。例如：

二、内置对象

官方文档：附录A： Thymeleaf 3.0 基础对象
官方文档：附录B： Thymeleaf 3.0 工具类

七大基础对象：

${#ctx} 上下文对象，可用于获取其它内置对象。
${#vars}: 上下文变量。
${#locale}：上下文区域设置。
${#request}: HttpServletRequest对象。
${#response}: HttpServletResponse对象。
${#session}: HttpSession对象。
${#servletContext}: ServletContext对象。

常用的工具类：

#strings：字符串工具类
#lists：List 工具类
#arrays：数组工具类
#sets：Set 工具类
#maps：常用Map方法。
#objects：一般对象类，通常用来判断非空
#bools：常用的布尔方法。
#execInfo：获取页面模板的处理信息。
#messages：在变量表达式中获取外部消息的方法，与使用＃{...}语法获取的方法相同。
#uris：转义部分URL / URI的方法。
#conversions：用于执行已配置的转换服务的方法。
#dates：时间操作和时间格式化等。
#calendars：用于更复杂时间的格式化。
#numbers：格式化数字对象的方法。
#aggregates：在数组或集合上创建聚合的方法。
#ids：处理可能重复的id属性的方法。

三、迭代循环

想要遍历List集合很简单，配合th:each 即可快速完成迭代。例如遍历用户列表：


 账号：
 密码：

在集合的迭代过程还可以获取状态变量，只需在变量后面指定状态变量名即可，状态变量可用于获取集合的下标/序号、总数、是否为单数/偶数行、是否为第一个/最后一个。例如：


 下标：
 序号：
 账号：
 密码：

如果缺省状态变量名，则迭代器会默认帮我们生成以变量名开头的状态变量 xxStat，例如：


 下标：
 序号：
 账号：
 密码：

四、条件判断

条件判断通常用于动态页面的初始化，例如：


 的确存在..

如果想取反则使用unless 例如：


 不存在..

五、日期格式化

使用默认的日期格式(toString方法) 并不是我们预期的格式：Mon Dec 03 23:16:50 CST 2018

此时可以通过时间工具类#dates来对日期进行格式化：2018-12-03 23:16:50

六、内联写法

（1）为什么要使用内联写法？·答：因为 JS无法获取服务端返回的变量。
（2）如何使用内联表达式？答：标准格式为：[[${xx}]] ，可以读取服务端变量，也可以调用内置对象的方法。例如获取用户变量和应用路径：

 <script th:inline="javascript">
 var user = [[${user}]];`
 var APP_PATH = [[${#request.getContextPath()}]];
 var LANG_COUNTRY = [[${#locale.getLanguage()+'_'+#locale.getCountry()}]];
 </script>

（3）标签引入的JS里面能使用内联表达式吗？答：不能！内联表达式仅在页面生效，因为Thymeleaf只负责解析一级视图，不能识别外部标签JS里面的表达式。

七、国际化

需要了解更多关于国际化的精彩描述请前往 SpringBoot 快速实现国际化i18n 。

例如在国际化文件中编写了user.title这个键值，然后使用#{}读取这个KEY即可获取翻译。

 用户登陆

八、详细教程

======== 有了上述基础后下面正式开始Thymeleaf 的详细教程 ==============

首先通过Spring Initializr创建项目，如图所示：

然后在POM文件引入web 、thymeleaf等依赖：


 
 org.springframework.boot
 spring-boot-starter-web
 
 
 org.springframework.boot
 spring-boot-starter-thymeleaf
 
 
 org.springframework.boot
 spring-boot-devtools
 runtime

然后在
src/main/resources/application.yml 配置页面路径：

spring:
 thymeleaf:
 cache: false #关闭缓存
 prefix: classpath:/views/ #调整页面路径

接着在
src/main/java/com/hehe/web/UserController 获取用户信息:

@RestController
public class UserController {
 private List userList = new ArrayList<>();
 {
 userList.add(new User("1", "socks", "123456", new Date()));
 userList.add(new User("2", "admin", "111111", new Date()));
 userList.add(new User("3", "jacks", "222222", null));
 }
 @GetMapping("/")
 public ModelAndView index() {
 return new ModelAndView("user/user", "userList", userList);
 }
}
public class User {
 private String id;
 private String username;
 private String password;
 private Date createTime;
 //请读者自行补充 构造器和 get/set方法..
}

开始编写公共页面：
src/main/resources/views/common/head.html ，其中static为页面片段：





 
 <script th:src="@{/webjars/jquery/jquery.js}"></script>

接着编写用户列表页：
src/main/resources/views/user/user.html 配合th:each显示用户列表信息。

使用说明：这里 th:replace="common/head::static" 表示将引用${spring.thymeleaf.prefix}/common/head.html的static页面片段，值得注意的是由于替换路径默认会拼接前缀路径，所以开头切勿在添加斜杠，否则在打包成JAR部署运行时将提示报Templates not found... 。




 
 User
 
 <script th:replace="common/head::static"></script>



 序号：
 账号：
 密码：
 时间：
 时间：

<script th:inline="javascript">
 //通过内联表达式获取用户信息
 var userList = [[${userList}]];
 console.log(userList)
</script>

然后编写单个用户页面：

至此大功告成，然后快速启动项目，如图所示：

快速启动项目

然后访问用户列表： http://localhost:8080 ，如图所示：

然后访问单个用户：
http://localhost:8080/user/1 ，如图所示：

美烦资源网

专注技术文章分享，涵盖编程教程、IT 资源与前沿资讯

SpringBoot Thymeleaf使用教程(实用版)

学习目标

使用教程