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

二、通过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";
    }
}

静态页面如下：

	
Hello World

4.Thymeleaf常用标签

常用的标签有：

关键字	功能介绍	案例
th:id	替换id
th:text	文本替换	description
th:utext	支持html的文本替换	conten
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判断相反	Login
th:href	链接地址	Login />
th:switch	多路选择 配合th:case 使用
th:case	th:switch的一个分支	User is an administrator
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