StringBoot（模板 Thymeleaf 高阶用法）

内联 [ [ ] ]

内联⽂本：[ […] ] 内联文本的表示方式，使⽤时，必须先⽤th:inline=“text/javascript/none” 激活，th:inline 可以在父级标签内使⽤，甚⾄可以作为 body 的标签。内联⽂本⽐ th:text 的代码少，不利于原型显示。

⻚页⾯面 inline.html（⽂文本内联）：

<div>
<h1>内联</h1>
<div th:inline="text" >
<p>Hello, [[${userName}]] !</p>
<br/>
</div>
</div>

以上代码等价于：

<div>
<h1>不不使⽤用内联</h1>
<p th:text="'Hello, ' + ${userName} + ' !'"></p>
<br/>
</div>

如果想在脚本中使⽤用后端传递的值，则必须使⽤用脚本内联，脚本内联可以在 js 中取到后台传过来的参数：

<script th:inline="javascript">
var name = [[${userName}]] + ', Sebastian';
alert(name);
</script>

注：不使用内联会先显示alert弹窗再显示内容。

基本对象

#ctx ：上下文对象
#vars ：上下文变量
#locale ：区域对象
#request ：（仅 Web 环境可用）HttpServletRequest 对象
#response ：（仅 Web 环境可⽤）HttpServletResponse 对象
#session ：（仅 Web 环境可用）HttpSession 对象
#servletContext ：（仅 Web 环境可用）ServletContext 对象

后台添加⽅法传值：

@RequestMapping("/object")
public String object(HttpServletRequest request) {request.setAttribute("request","i am request");
request.getSession().setAttribute("session","i am session");
return "object";
}

使⽤用 request 和 session 分别传递了了⼀一个值，再来查看⻚页⾯面 object.html。

<body>
<div >
<h1>基本对象</h1>
<p th:text="${#request.getAttribute('request')}">
<br/>
<p th:text="${session.session}"></p>
Established locale country: <span th:text="${#locale.country}">CN</span>.
</div>
</body>

内嵌变量

dates：java.util.Date 的功能⽅方法类
calendars：类似 #dates，⾯面向 java.util.Calendar
numbers：格式化数字的功能⽅方法类
strings：字符串串对象的功能类，contains、startWiths、prepending/appending 等
objects：对 objects 的功能类操作
bools：对布尔值求值的功能⽅方法
arrays：对数组的功能类⽅方法
lists：对 lists 的功能类⽅方法
sets：set 的实⽤用⽅方法
maps：map 的实⽤用⽅方法
1. dates

<!--格式化时间-->
<p th:text="${#dates.format(date, 'yyyy-MM-dd HH:mm:ss')}">neo</p>
<!--创建当前时间 精确到天-->
<p th:text="${#dates.createToday()}">neo</p>
<!--创建当前时间 精确到秒-->
<p th:text="${#dates.createNow()}">neo</p>

2. strings

<!--判断是否为空-->
<p th:text="${#strings.isEmpty(userName)}">userName</p>
<!--判断 list 是否为空-->
<p th:text="${#strings.listIsEmpty(users)}">userName</p>
<!--输出字符串长度-->
<p th:text="${#strings.length(userName)}">userName</p>
<!--拼接字符串-->
<p th:text="${#strings.concat(userName,userName,userName)}"></p>
<!--创建⾃定长度的字符串-->
<p th:text="${#strings.randomAlphanumeric(count)}">userName</p>

后端传值：

@RequestMapping("/utility")
public String utility(ModelMap map) {map.addAttribute("userName", "neo");
map.addAttribute("users", getUserList());
map.addAttribute("count", 12);
map.addAttribute("date", new Date());
return "utility";
}

显示效果：

内嵌变量量
2018-09-26 20:49:07
Wed Sep 26 00:00:00 CST 2018
Wed Sep 26 20:49:07 CST 2018
false
[false, false, false]
3
neoneoneo
QKERBVPRHFS9

表达式

表达式共分为以下五类。

变量量表达式：${…}
选择或星号表达式：*{…}
⽂文字国际化表达式：#{…}
URL 表达式：@{…}
⽚片段表达式：~{…}

变量量表达式
变量表达式即 OGNL 表达式或 Spring EL 表达式（在 Spring 术语中也叫 model attributes），类似${session.user.name}

<span th:text="${book.author.name}">
<li th:each="book : ${books}">

选择（星号）表达式
选择表达式很像变量表达式，不不过它们用一个预先选择的对象来代替上下文变量容器（map）来执行，类似： *{customer.name} 。

<div th:object="${book}">
...
<span th:text="*{title}">...</span>
...
</div>

被指定的 object 由 th:object 属性定义：

<div th:object="${book}">
...
<span th:text="*{title}">...</span>
...
</div>

title 即为 book 的属性。

文字国际化表达式
⽂字国际化表达式允许我们从⼀个外部文件获取区域文字信息（.properties），用 Key 索引 Value，还可以提供⼀组参数（可
选）。

<table>
...
<th th:text="#{header.address.city}">...</th>
<th th:text="#{header.address.country}">...</th>
...
</table>

URL 表达式
URL 表达式指的是把一个有⽤的上下⽂文或回话信息添加到 URL，这个过程经常被叫做 URL 重写，比如 @{/order/list} 。

URL 还可以设置参数： @{/order/details(id=${orderId})} 相对路路径：
@{…/documents/report}

<form th:action="@{/createOrder}">
<a href="main.html" th:href="@{/main}">

片段表达式
⽚段表达式是 3.x 版本新增的内容。⽚段表达式是一种标记的片段，并将其移动到模板中的⽅方法。⽚段表达式的优势是，片段可以被复制或者作为参数传递给其他模板等。
最常见的⽤法是使⽤ th:insert 或 th:replace: 插入片段：

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

也可以在⻚面的其他位置去使用：

<div th:with="frag=~{footer :: #main/text()}">
<p th:insert="${frag}">
</div>

常用 th 标签

还有⾮常多的标签，这⾥只列列出最常用的几个，由于一个标签内可以包含多个 th:x 属性，其生效的优先级顺序为：

include,each,if/unless/switch/case,with,attr/attrprepend/attrappend,value/href,src ,etc,text/utex
t,fragment,remove

Thymeleaf 配置

我们可以通过 application.properties ⽂件灵活的配置 Thymeleaf 的各项特性，以下为 Thymeleaf 的配置和默认参数：

# THYMELEAF (ThymeleafAutoConfiguration)
#开启模板缓存（默认值：true）
spring.thymeleaf.cache=true
#检查模板是否存在，然后再呈现
spring.thymeleaf.check-template=true
#检查模板位置是否正确（默认值:true）
spring.thymeleaf.check-template-location=true
#Content-Type的值（默认值：text/html）
spring.thymeleaf.content-type=text/html
#开启MVC Thymeleaf视图解析（默认值：true）
spring.thymeleaf.enabled=true
#模板编码
spring.thymeleaf.encoding=UTF-8
#要被排除在解析之外的视图名称列列表，⽤用逗号分隔
spring.thymeleaf.excluded-view-names=
#要运⽤用于模板之上的模板模式。另⻅见StandardTemplate-ModeHandlers(默认值：HTML5)
spring.thymeleaf.mode=HTML5
#在构建URL时添加到视图名称前的前缀（默认值：classpath:/templates/）
spring.thymeleaf.prefix=classpath:/templates/
#在构建URL时添加到视图名称后的后缀（默认值：.html）
spring.thymeleaf.suffix=.html
#Thymeleaf 模板解析器器在解析器器链中的顺序，默认情况下，它排第⼀一位，顺序从1开始，只有在定义了了额外的 TemplateResolv
er Bean 时才需要设置这个属性。
spring.thymeleaf.template-resolver-order=
#可解析的视图名称列列表，⽤用逗号分隔
spring.thymeleaf.view-names=