SpringBoot学习笔记【part12】Web开发——Thymeleaf模板引擎
SpringBoot 学习笔记 Part12
1. thymeleaf简介
SpringBoot默认不支持 JSP，需要引入第三方模板引擎技术实现页面渲染。
Thymeleaf is a modern server-side Java template engine for both web and standalone environments, capable of processing HTML, XML, JavaScript, CSS and even plain text.
即 thymeleaf 是现代化、服务端的Java模板引擎。
2. 基本语法
-
表达式
表达式名 语法 作用 变量取值 ${…} 获取请求域、session域、对象等值 选择变量 *{…} 获取上下文对象值 消息 #{…} 获取国际化等值 链接 @{…} 生成链接 片段表达式 ~{…} jsp:include 作用，引入公共页面片段 行内表达式 [[…]] HTML 文本中嵌套表达式 -
字面量
文本值：‘one text’ ， ‘another one’
数字：0 , 34 , 3.0 , 12.3
布尔值：true , false
空值：null
变量：one，two
-
文本操作
字符串拼接: +
变量替换: |The name is ${name}|
-
数字运算
运算符: + , - , * , / , %
-
布尔运算
运算符: and , or
一元运算: ! , not
-
比较运算
比较: > , < , >= , <= ( gt , lt , ge , le )
等式: == , != ( eq , ne )
-
条件运算
If-then： (if) ？(then)
If-then-else： (if) ? (then) ：(else)
Default： (value) ? ：(defaultvalue)
-
特殊操作
无操作： _
3. 标签th:attr
th:attr 用来设置属性值。
- 设置单个值：
<form action="subscribe.html" th:attr="action=@{/subscribe}">
<fieldset>
<input type="text" name="email" />
<input type="submit" value="Subscribe!" th:attr="value=#{subscribe.submit}"/>
fieldset>
form>
- 设置多个值：
<img src="../../images/gtvglogo.png" th:attr="src=@{/images/gtvglogo.png},title=#{logo},alt=#{logo}" />
- 以上两个的代替写法：
<input type="submit" value="Subscribe!" th:value="#{subscribe.submit}"/>
<form action="subscribe.html" th:action="@{/subscribe}">
所有h5兼容的标签写法可参考官方文档：https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#setting-value-to-specific-attributes
4. 迭代
foreach：
- 迭代普通类型：
<tr th:each="prod : ${prods}">
<td th:text="${prod.name}">Onionstd>
<td th:text="${prod.price}">2.41td>
<td th:text="${prod.inStock}? #{true} : #{false}">yestd>
tr>
- 迭代对象：
<tr th:each="prod,iterStat : ${prods}" th:class="${iterStat.odd}? 'odd'">
<td th:text="${prod.name}">Onionstd>
<td th:text="${prod.price}">2.41td>
<td th:text="${prod.inStock}? #{true} : #{false}">yestd>
tr>
5. 条件运算
if：
<a href="comments.html"
th:href="@{/product/comments(prodId=${prod.id})}"
th:if="${not #lists.isEmpty(prod.comments)}">viewa>
switch：
<div th:switch="${user.role}">
<p th:case="'admin'">User is an administratorp>
<p th:case="#{roles.manager}">User is a managerp>
<p th:case="*">User is some other thingp>
div>
6. 属性优先级
所有Thymeleaf属性都有一个数字优先级，以建立他们在标签中的顺序执行。这个顺序是:
| Order | Feature | Attributes |
|---|---|---|
| 1 | Fragment inclusion | th:include th:replace |
| 2 | Fragment iteration | th:each |
| 3 | Conditional evaluation | th:if th:unless th:switch th:case |
| 4 | Local variable definition | th:object th:with |
| 5 | General attribute modification | th:attr th:attrprepend th:attrappend |
| 6 | Specific attribute modification | th:value, th:href, th:src, etc. |
| 7 | Text (tag body modification) | th:text th:utext |
| 8 | Fragment specification | th:fragment |
| 9 | Fragment removal | th:remove |
7. thymeleaf的使用
首先，我们需要引入thymeleaf的starter场景启动器。
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>
我们可以在 springboot 中找到 thymeleaf 的自动配置类，这说明springboot已经为我们做好了默认配置的工作。
@Configuration(proxyBeanMethods = false)
@EnableConfigurationProperties(ThymeleafProperties.class)
@ConditionalOnClass({ TemplateMode.class, SpringTemplateEngine.class })
@AutoConfigureAfter({ WebMvcAutoConfiguration.class, WebFluxAutoConfiguration.class })
public class ThymeleafAutoConfiguration { }
查看 springboot 的 thymeleaf 的自动配置类，在自动配置类里我们可以找到一些已经配好的重要组件，如spring模板引擎 SpringTemplateEngine、thymeleaf 的视图解析器 ThymeleafViewResolver 等。并且我们发现所有thymeleaf的配置值都在 ThymeleafProperties 类里，这个是存储配置信息的配置类，之前学习过。
public static final String DEFAULT_PREFIX = "classpath:/templates/";
public static final String DEFAULT_SUFFIX = ".html"; //xxx.html
ThymeleafProperties 类中这两个重要属性表明了我们开发的页面路径和映射规则，因此我们不需要别的配置，直接进行开发就行了。
注：在html页面开发中为了更方便地使用thymeleaf标签属性，应在标签中引入thymeleaf的命名空间 xmlns:th=“http://www.thymeleaf.org”，如下：
DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Titletitle>
head>
<body>
body>
html>
8. 开发小案例
h5中编写如下：
DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Titletitle>
head>
<body>
<h1 th:text="${msg}">Hello H5 !h1>
<h2>
<a href="www.4399.com" th:href="${link}">去百度a>
h2>
body>
html>
Controller中编写如下：
@Controller
public class thymeleafController {
@GetMapping("/thymeleaf")
public String gotoThymeleaf(Model model){
model.addAttribute("msg","Hello Thymelef !");
model.addAttribute("link","http://www.baidu.com");
return "success";
}
}