摘要
看完本文你将掌握如下知识点：
- Spring Boot(2.0.4)中使用thymeleaf(3.0.9)的常用语法
项目准备
依赖
org.springframework.boot
spring-boot-starter-thymeleaf
开启spring boot对thymeleaf的支持
##thymeleaf
spring.thymeleaf.enabled=true
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.mode=HTML
#关闭页面缓存
spring.thymeleaf.cache=false
spring.thymeleaf.servlet.content-type=text/html
也可以通过@Bean的方式开启支持
@Bean
public ThymeleafViewResolver thymeleafViewResolver(){
log.info("thymeleafViewResolver");
ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
viewResolver.setTemplateEngine(templateEngine());
viewResolver.setOrder(1);
viewResolver.setCharacterEncoding("UTF-8");
viewResolver.setContentType("text/html");
viewResolver.setCache(false);
return viewResolver;
}
@Bean
public SpringResourceTemplateResolver templateResolver(){
SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver();
templateResolver.setApplicationContext(this.applicationContext);
templateResolver.setPrefix("classpath:/templates/");
templateResolver.setSuffix(".html");
templateResolver.setTemplateMode(TemplateMode.HTML);
templateResolver.setCacheable(false);
return templateResolver;
}
@Bean
public SpringTemplateEngine templateEngine(){
SpringTemplateEngine templateEngine = new SpringTemplateEngine();
templateEngine.setTemplateResolver(templateResolver());
templateEngine.setEnableSpringELCompiler(true);
return templateEngine;
}
开启html页面对thymeleaf语法的支持
语法
各种表达式语法
1.${...} 变量表达式，用于展示后台传递过来的变量（request和session中的值）
以下两种方式效果一致
[[${dataObj.name}]]
字符串拼接，可以使用加号，也可以使用竖线，以下两种方式效果一致
[[${type.name}]
[[${type.name}]
#dates与java.util.Date对象的方法对应，格式化、日期组件抽取等等
[[${#dates.format(item.logTime, 'yyyy-MM-dd')}]]
2.#{...} 国际化消息表达式，用于展示message.properties等国际化资源文件中的内容
消息中需要传递变量的情况，多个变量逗号分割
以下两种方式效果一致
[[#{common.operate}]]
3.@{...} 链接url表达式，用于封装url，如contextPath补全
用两个竖线来拼接带表达式的字符串
带请求参数的url，多个用逗号分割
4.js和css中用到表达式时使用双中括号的方式
var modify = "[[${modify}]]";
if(modify != "add"){
$("#password").attr("placeholder","[[#{user.detail.changeNotice}]]");
}
5.*{...} 选择变量表达式，用于简写变量名称，需要配合th:object一起使用
firstName:
lastName:
相当于
firstName:
lastName:
6.~{...} 代码块表达式，用于在html中复用相同的结构
语法：~{templatename::fragmentname}
示例：
common/model.html，th:fragment="header"指定代码块名称
demo.html，th:replace="common/model::header"，模板名称::代码块名称
说明：代码块表达式需要配合th属性（th:insert，th:replace，th:include）一起使用。
th:insert：将代码块片段整个插入到使用了th:insert的HTML标签中，
th:replace：将代码块片段整个替换使用了th:replace的HTML标签中，
th:include：将代码块片段包含的内容插入到使用了th:include的HTML标签中，
遍历
简单示例
[[${#dates.format(item.logTime, 'yyyy-MM-dd')}]]
带遍历状态的示例
[[${#dates.format(item.logTime, 'yyyy-MM-dd')}]]
- 状态说明
index：当前遍历索引，从0开始
count：当前遍历索引，从1开始
size：总元素数量
current：每一次遍历的iter变量
even/odd：当前遍历是even还是odd，布尔属性
first：当前遍历是第一个，布尔属性
last：当前遍历是最后一个，布尔属性
遍历时可以自定义变量
th:with：用于定义变量，多个使用逗号分割
[[${shwoName}]]
,
条件判断
th:if
判断为true时才会显示div，authorities为Set类型，所以判断是否包含时可以使用#sets.contains()方法，测试时发现使用#arrays.contains()方法时也可以
如果要判断为false时才会显示div，可以判断值是否等于false，或者使用th:unless
- th:if 以下情况运算为true
值不为null
值为boolean且为true
值为数字且非0
值为字符且非0
值是字符串且不是：“false”，“off”，“no”
值是object,但不为null
th:switch 和 th:case
bool匹配
true
false
字符串匹配，要加单引号
administrator
manager
administrator
manager
unknow
- 说明：th:case="*" 表示没有匹配成功时显示的内容
运算符
- 字符串连接
+ : ${item.id}+'_'+${type.id}
|xxxx| : |The name is ${name}|
- 算术运算
+ , - , * , / , % (二元运算符)
- :负号（一元运算符）
- 布尔操作
and :且,or :或 (二元运算符)
!,not :非（一元操作符）
- 关系操作符
> , < , >= , <= (gt , lt , ge , le)
== , != (eq, ne)
表达式工具对象
#dates 与java.util.Date对象的方法对应，格式化、日期组件抽取等等
#calendars 类似#dates，与java.util.Calendar对象对应
#numbers 格式化数字对象的工具方法
#strings 与java.lang.String对应的工具方法：contains、startsWith、prepending/appending等等
#objects 用于对象的工具方法
#bools 用于布尔运算的工具方法
#arrays 用于数组的工具方法
#lists 用于列表的工具方法
#sets 用于set的工具方法
#maps 用于map的工具方法
#aggregates 用于创建数组或集合的聚合的工具方法
#messages 用于在变量表达式内部获取外化消息的工具方法，与#{…}语法获取的方式相同
#ids 用于处理可能重复出现（例如，作为遍历的结果）的id属性的工具方法
使用springsecurity权限标签的方法
添加依赖
org.thymeleaf.extras
thymeleaf-extras-springsecurity4
3.0.2.RELEASE
开启命名空间支持
使用方式与jsp标签类似：
调用spring管理的bean的方法
语法：${@beanName.methodName(param,...)}
说明：beanName就是注册时的名称
示例：
#httpSession就是javax.servlet.http.HttpSession对象
#httpServletRequest就是javax.servlet.http.HttpServletRequest对象
参考资料
- https://www.cnblogs.com/itdragon/archive/2018/04/13/8724291.html
- https://blog.csdn.net/abap_brave/article/details/53009149