SpringBoot学习1.7-配置Thymeleaf渲染页面及常用标签说明
环境：
jdk1.8；spring boot2.0.2；Maven3.3
摘要说明：
前面我们已经主要讲述如何进行接口开发，接口开发之后如何进行页面渲染？
spring boot默认不支持jsp；主要支持下面渲染模版：
- Thymeleaf
- FreeMarker
- Velocity
- Groovy
- Mustache
本篇文章主要讲述如何配置使用Thymeleaf模版引擎进行页面渲染；
Thymeleaf是一个XML/XHTML/HTML5模板引擎，可用于Web与非Web环境中的应用开发。它是一个开源的Java库，基于Apache License 2.0许可，由Daniel Fernández创建，该作者还是Java加密库Jasypt的作者。
步骤：
1.依赖
引入依赖：
org.springframework.boot
spring-boot-starter-thymeleaf
这里先阐述下Thymeleaf可以使用的mode如下：
- XML
- Valid XML
- XHTML
- Valid XHTML
- HTML5（默认）
- Legacy HTML5
由于除了Legacy HTML5之外，其他模式都必须是闭合的（标签），也就是说不支持不规范的HTML标签写法；
对于配置了Legacy HTML5模式的情况，Legacy HTML5先转换为规范写法的H5，so官方建议使用H5的代码来写模板；
这里说的使用Legacy HTML5需要另外引入依赖：
net.sourceforge.nekohtml
nekohtml
1.9.22
2.Thymeleaf配置
渲染页面首先需要放置静态页面；
Spring Boot默认提供静态资源目录位置需置于classpath下即放置在src/main/resources/下，目录名需符合如下规则：‘
- /static
- /public
- /resources
- /META-INF/resources
本篇文章使用常用的static；
Thymeleaf配置如下，主要指定前后缀及缓存：
#
spring.thymeleaf.cache=false
## 检查模板是否存在，然后再呈现
spring.thymeleaf.check-template-location=true
#Content-Type值
spring.thymeleaf.content-type=text/html
#启用MVC Thymeleaf视图分辨率
spring.thymeleaf.enabled=true
# 在构建URL时预先查看名称的前缀
spring.thymeleaf.prefix=classpath:/static/
# 构建URL时附加查看名称的后缀.
spring.thymeleaf.suffix=.html
## 应该从解决方案中排除的视图名称的逗号分隔列表
#spring.thymeleaf.excluded-view-names=
#模板编码默认为html5
#spring.thymeleaf.mode=LEGACYHTML5
# 链中模板解析器的顺序
#spring.thymeleaf.template-resolver-order=o
# 可以解析的视图名称的逗号分隔列表
#spring.thymeleaf.view-names=3.页面开发
静态资源开发结构如下：
两种方式访问页面；
一、直接访问页面，如http://127.0.0.1:xxxx/xx/test/html/test.html
Insert title here
二、通过controller进行跳转，同时使用Thymeleaf标签，如http://127.0.0.1:xxxx/xx/test1：
这里面注意的是使用@Controller注解而不是@RestController;因为后者默认返回json类型；
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller//注意这里是@Controller而不是@RestController
public class TestThymeleafController {
@RequestMapping("/test1")
public String index(ModelMap map) {
// 加入一个属性，用来在模板中读取
map.addAttribute("host", "https://blog.csdn.net/u010904188/");
// return模板文件的名称，对应src\main\resources\static\test\html\test1.html
return "test/html/test1";
}
}
静态页面如下：
Insert title here
Hello World
4.Thymeleaf常用标签
常用的标签有：
| 关键字 | 功能介绍 | 案例 |
| th:id | 替换id | |
| th:text | 文本替换 | |
| th:utext | 支持html的文本替换 | |
| th:object | 替换对象 | |
| th:value | 属性赋值 | |
| th:with | 变量赋值运算 | |
| th:style | 设置样式 | th:style="'display:' + @{(${sitrue} ? 'none' : 'inline-block')} + ''" |
| th:onclick | 点击事件 | th:οnclick="'getCollect()'" |
| th:each | 属性赋值 | tr th:each="user,userStat:${users}"> |
| th:if | 判断条件 | |
| th:unless | 和th:if判断相反 | |
| th:href | 链接地址 | |
| th:switch | 多路选择 配合th:case 使用 | |
| th:case | th:switch的一个分支 | |
| th:fragment | 布局标签，定义一个代码片段，方便其它地方引用 | |
| th:include | 布局标签，替换内容到引入的文件 | |
| th:replace | 布局标签，替换整个标签到引入的文件 | |
| th:selected | selected选择框选中 | th:selected="(${xxx.id} == ${configObj.dd})" |
| th:src | 图片类地址引入 | |
| th:inline | 定义js脚本可以使用变量 | |
| th:action | 表单提交的地址 | |
| th:attr | 设置标签属性，多个属性可以用逗号分隔 | 比如 th:attr="src=@{/image/aa.jpg},title=#{logo}"，此标签不太优雅，一般用的比较少。 |
常用数据类型：
- #dates：日期格式化内置对象，具体方法可以参照java.util.Date；
- #calendars：类似于#dates，但是是java.util.Calendar类的方法；
- #numbers： 数字格式化；
- #strings：字符串格式化，具体方法可以参照java.lang.String，如startsWith、contains等；
- #objects：参照java.lang.Object；
- #bools：判断boolean类型的工具；
- #arrays：数组操作的工具；
- #lists：列表操作的工具，参照java.util.List；
- #sets：Set操作工具，参照java.util.Set；
- #maps：Map操作工具，参照java.util.Map；
- #aggregates：操作数组或集合的工具；
- #messages：操作消息的工具。
更多可参考：https://www.thymeleaf.org/doc/tutorials/2.1/usingthymeleaf.html#standard-expression-syntax