SpringBoot学习1.7-配置Thymeleaf渲染页面及常用标签说明

xiaoxiao2021-04-16  36

环境:

jdk1.8;spring boot2.0.2;Maven3.3

摘要说明:

前面我们已经主要讲述如何进行接口开发,接口开发之后如何进行页面渲染? spring boot默认不支持jsp;主要支持下面渲染模版:

ThymeleafFreeMarkerVelocityGroovyMustache

本篇文章主要讲述如何配置使用Thymeleaf模版引擎进行页面渲染;

Thymeleaf是一个XML/XHTML/HTML5模板引擎,可用于Web与非Web环境中的应用开发。它是一个开源的Java库,基于Apache License 2.0许可,由Daniel Fernández创建,该作者还是Java加密库Jasypt的作者。

步骤:

1.依赖

引入依赖:

<!-- 引入thymeleaf渲染模板 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>

这里先阐述下Thymeleaf可以使用的mode如下:

XMLValid XMLXHTMLValid XHTMLHTML5(默认)Legacy HTML5

由于除了Legacy HTML5之外,其他模式都必须是闭合的(标签),也就是说不支持不规范的HTML标签写法;

对于配置了Legacy HTML5模式的情况,Legacy HTML5先转换为规范写法的H5,so官方建议使用H5的代码来写模板;

这里说的使用Legacy HTML5需要另外引入依赖:

<dependency> <groupId>net.sourceforge.nekohtml</groupId> <artifactId>nekohtml</artifactId> <version>1.9.22</version> </dependency>

2.Thymeleaf配置

渲染页面首先需要放置静态页面;

Spring Boot默认提供静态资源目录位置需置于classpath下即放置在src/main/resources/下,目录名需符合如下规则:‘

/static/public/resources/META-INF/resources

本篇文章使用常用的static;

Thymeleaf配置如下,主要指定前后缀及缓存:

#<!-- 关闭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

<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Insert title here</title> <script type="text/javascript" src="../js/jquery-1.11.2.js"></script> <script> $(function() { $.ajax({ async : false, type : "post", url : "../../swagger-resources/", data : null, dataType : 'json', success : function(data) { console.log(data); }, error : function() { alert("请求服务超时"); } }); }); </script> </head> <body> <image src="../img/IMG_0143.JPG"></image> </body> </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"; } }

静态页面如下:

<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Insert title here</title> </head> <body> <h1 th:text="${host}">Hello World</h1> </body> </html>

4.Thymeleaf常用标签

常用的标签有:

关键字功能介绍案例th:id替换id<input th:id="'xxx' + ${collect.id}"/>th:text文本替换<p th:text="${collect.description}">description</p>th:utext支持html的文本替换<p th:utext="${htmlcontent}">conten</p>th:object替换对象<div th:object="${session.user}">th:value属性赋值<input th:value="${user.name}" />th:with变量赋值运算<div th:with="isEven=${prodStat.count}%2==0"></div>th:style设置样式th:style="'display:' + @{(${sitrue} ? 'none' : 'inline-block')} + ''"th:onclick点击事件th:οnclick="'getCollect()'"th:each属性赋值tr th:each="user,userStat:${users}">th:if判断条件<a th:if="${userId == collect.userId}" >th:unless和th:if判断相反<a th:href="@{/login}" th:unless=${session.user != null}>Login</a>th:href链接地址<a th:href="@{/login}" th:unless=${session.user != null}>Login</a> />th:switch多路选择 配合th:case 使用<div th:switch="${user.role}">th:caseth:switch的一个分支<p th:case="'admin'">User is an administrator</p>th:fragment布局标签,定义一个代码片段,方便其它地方引用<div th:fragment="alert">th:include布局标签,替换内容到引入的文件<head th:include="layout :: htmlhead" th:with="title='xx'"></head>th:replace布局标签,替换整个标签到引入的文件<div th:replace="fragments/header :: title"></div>th:selectedselected选择框选中th:selected="(${xxx.id} == ${configObj.dd})"th:src图片类地址引入<img class="img-responsive" alt="App Logo" th:src="@{/img/logo.png}" />th:inline定义js脚本可以使用变量<script type="text/javascript" th:inline="javascript">th:action表单提交的地址<form action="subscribe.html" th:action="@{/subscribe}">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

转载请注明原文地址: https://www.6miu.com/read-4818104.html

最新回复(0)