使用Thymeleaf 三大理由：

简洁漂亮容易理解
完美支持HTML5 使用浏览器直接打开页面
不新增标签只需增强属性

学习目标

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

快速查阅

源码下载：springboot-web-thymeleaf-enhance

— Hey Man，Don't forget to Star or Fork . —

官方指南：Thymleaf 3.0 官方教程

使用教程

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

一、基础语法

变量表达式 `${}`

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

<form id="userForm">

    <input id="id" name="id" th:value="${user.id}"/>

    <input id="username" name="username" th:value="${user.username}"/>

    <input id="password" name="password" th:value="${user.password}"/>

</form>

<div th:text="hello"></div>

<div th:text="${user.username}"></div>

选择变量表达式 `*{}`

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

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

<form id="userForm" th:object="${user}">

    <input id="id" name="id" th:value="*{id}"/>

    <input id="username" name="username" th:value="*{username}"/>

    <input id="password" name="password" th:value="*{password}"/>

</form>

链接表达式 `@{}`

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

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

<link th:href="@{/webjars/bootstrap/css/bootstrap.css}" rel="stylesheet" type="text/css">

片段表达式 `~{}`

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

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

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

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

<!-- /views/common/head.html-->

<head th:fragment="static">

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

</head>

<!-- /views/your.html -->

<div th:replace="~{common/head::static}"></div>

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

<!-- your.html -->

<div th:replace="common/head::static"></div>

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

消息表达式

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

<title th:text="#{user.title}"></title>

其它表达式

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

<input name="name" th:value="${'I am '+(user.name!=null?user.name:'NoBody')}"/>

二、内置对象

官方文档：附录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 即可快速完成迭代。例如遍历用户列表：

<div th:each="user:${userList}">

    账号：<input th:value="${user.username}"/>

    密码：<input th:value="${user.password}"/>

</div>

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

<div th:each="user,stat:${userList}" th:class="${stat.even}?'even':'odd'">

    下标：<input th:value="${stat.index}"/>

    序号：<input th:value="${stat.count}"/>

    账号：<input th:value="${user.username}"/>

    密码：<input th:value="${user.password}"/>

</div>

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

<div th:each="user:${userList}" th:class="${userStat.even}?'even':'odd'">

    下标：<input th:value="${userStat.index}"/>

    序号：<input th:value="${userStat.count}"/>

    账号：<input th:value="${user.username}"/>

    密码：<input th:value="${user.password}"/>

</div>

四、条件判断

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

<div th:if="${userList}">

    <div>的确存在..</div>

</div>

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

<div th:unless="${userList}">

    <div>不存在..</div>

</div>

五、日期格式化

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

<input type="text" th:value="${user.createTime}"/>

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

<input type="text" th:value="${#dates.format(user.createTime,'yyyy-MM-dd HH:mm:ss')}"/>

六、内联写法

（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即可获取翻译。

<title th:text="#{user.title}">用户登陆</title>

八、详细教程

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

首先通过Spring Initializr创建项目，

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

<dependencies>

        <dependency><!--Web相关依赖-->

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

        <dependency><!--页面模板依赖-->

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-thymeleaf</artifactId>

        </dependency>

        <dependency><!--热部署依赖-->

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-devtools</artifactId>

            <scope>runtime</scope>

        </dependency>

    </dependencies>

然后在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<User> 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为页面片段：

<!DOCTYPE html>

<html xmlns:th="http://www.thymeleaf.org">

<!--声明static为页面片段名称-->

<head th:fragment="static">

    <link th:href="@{/webjars/bootstrap/css/bootstrap.css}" rel="stylesheet" type="text/css"/>

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

</head>

</html>

接着编写用户列表页：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... 。

<!DOCTYPE html>

<html xmlns:th="http://www.thymeleaf.org">

<head>

    <meta charset="UTF-8"/>

    <title th:text="用户信息">User</title>

    <!--默认拼接前缀路径,开头请勿再添加斜杠,防止部署运行报错！-->

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

</head>

<body>

<div th:each="user,userStat:${userList}" th:class="${userStat.even}?'even':'odd'">

    序号：<input type="text" th:value="${userStat.count}"/>

    账号：<input type="text" th:value="${user.username}"/>

    密码：<input type="password" th:value="${user.password}"/>

    时间：<input type="text" th:value="${user.createTime}"/>

    时间：<input type="text" th:value="${#dates.format(user.createTime,'yyyy-MM-dd HH:mm:ss')}"/>

</div>

<script th:inline="javascript">

    //通过内联表达式获取用户信息

    var userList = [[${userList}]];

    console.log(userList)

</script>

</body>

</html>

然后编写单个用户页面：

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

快速启动项目

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

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

SpringBoot与Thymeleaf入门级操作的更多相关文章

【原】无脑操作：IDEA + maven + Shiro + SpringBoot + JPA + Thymeleaf实现基础授权权限
上一篇<[原]无脑操作:IDEA + maven + Shiro + SpringBoot + JPA + Thymeleaf实现基础认证权限>介绍了实现Shiro的基础认证.本篇谈谈实现 ...
【原】无脑操作：IDEA + maven + Shiro + SpringBoot + JPA + Thymeleaf实现基础认证权限
开发环境搭建参见<[原]无脑操作:IDEA + maven + SpringBoot + JPA + Thymeleaf实现CRUD及分页> 需求: ① 除了登录页面,在地址栏直接访问其他 ...
Springboot+JPA+Thymeleaf 校园博客完整小网站
本文所属[知识林]:http://www.zslin.com/web/article/detail/35 此项目是一个比较简易的校园博客.麻雀虽小五脏俱全,虽然是比较简易的但是涉及的知识点还是比较全面 ...
从.Net到Java学习第九篇——SpringBoot下Thymeleaf
从.Net到Java学习系列目录 Thymeleaf概述 Thymeleaf 是一个流行的模板引擎,该模板引擎采用java语言开发.模板引擎是一个技术名称,是跨领域平台的概念,在java语言体系下有模 ...
IDEA上创建 Maven SpringBoot+mybatisplus+thymeleaf 项目
概述在WEB领域,Java也是在不断的探索和改进,从开始的JSP--->Struts1--->Struts2+Spring--->Spring MVC--->SpringBo ...
springboot引入thymeleaf
springboot引入thymeleaf 1.Thymeleaf使用 @ConfigurationProperties(prefix = "spring.thymeleaf") ...
SpringBoot入坑-持久化操作
前面内容中我们已经了解到了SpringBoot关于参数传递的相关知识,本篇我们一起来学习一下SpringBoot关于数据库持久化操作的知识,这里我们使用JPA进行数据库的持久化操作. 首先由于我们需要 ...
【Springboot】Springboot整合Thymeleaf模板引擎
Thymeleaf Thymeleaf是跟Velocity.FreeMarker类似的模板引擎,它可以完全替代JSP,相较与其他的模板引擎,它主要有以下几个特点: 1. Thymeleaf在有网络和无 ...
从.Net到Java学习第六篇——SpringBoot+mongodb&Thymeleaf&模型验证
SpringBoot系列目录 SpringBoot整合mongodb MongoDB 是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的.如果你没用过Mong ...
SpringBoot 之Thymeleaf模板.
一.前言 Thymeleaf 的出现是为了取代 JSP,虽然 JSP 存在了很长时间,并在 Java Web 开发中无处不在,但是它也存在一些缺陷: 1.JSP 最明显的问题在于它看起来像HTML或X ...

随机推荐

Linux无头模式使用mat分析dump的方法
摘要 mat可以很好的进行jvm的内存dump的分析. 但是大部分服务器是没有GUI界面的. 而且就算是有GUI界面也很难直接使用. 但是随着jvm堆区越来越大. WindowsPC机器已经很难进行分 ...
简单的获取ESXi服务器上面开启了多少个vCPU的办法
开启ssh 执行命令 esxcli vm process list |grep Config |cut -b 17- |xargs cat |grep numvcpus |cut -d " ...
开发QQ官方机器人
QQ 频道机器人开发简明教程 1. 简介 QQ 频道机器人是一种可以在 QQ 频道中与用户进行互动的服务.这个教程旨在帮助新手学习如何使用 Python 的官方SDK,快速实现一些基本的机器人功能. ...
Jmeter报错权限不够
Jmeter报错权限不够解决办法: chmod +x jmeter
关于大数乘法的数组类型问题(int 还是char)
可以知道在处理高精度乘法的时候,我们是不考虑当场进位的,在所有位数都模拟完竖式乘法后才进行逐位进位,这就要求存储每个位的数组保证不会爆掉溢出众所周知char类型最多只能存储到255,非常非常容易溢出 ...
ASP.NET Core分布式项目实战（详解oauth2授权码流程）--学习笔记
最近公司产品上线,通宵加班了一个月,一直没有更新,今天开始恢复,每日一更,冲冲冲任务13:详解oauth2授权码流程我们即将开发的产品有一个用户 API,一个项目服务 API,每个服务都需要认证授 ...
JS 从零手写一个深拷贝（进阶篇）
壹 ❀ 引在深拷贝与浅拷贝的区别,实现深拷贝的几种方法一文中,我们阐述了深浅拷贝的概念与区别,普及了部分具有迷惑性的浅拷贝api.当然,我们也实现了乞丐版的深拷贝方法,能解决部分拷贝场景,虽然它仍有 ...
NEMU PA 4 实验报告
一.实验目的在前面的PA123中,我们分别实现了基本的运算单元,实现了各种指令和程序的装载,实现了存储器的层次结构.而在PA4中,为了让NEMU可以处理异常情况以及和外设交互,我们要做的事情有以下: ...
Js中Reflect对象
Js中Reflect对象 Reflect是ES6起JavaScript内置的对象,提供拦截JavaScript操作的方法,这些方法与Proxy对象的handlers中的方法基本相同. 描述 Refle ...
使用html+css+js实现一个仿钉钉打卡按钮
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

SpringBoot与Thymeleaf入门级操作