SpringBoot之thymeleaf的使用

SpringBoot之thymeleaf的使用

Scroll Down

前言

web开发的模板引擎是为了使用户界面与业务数据(内容)分离而产生的,它可以生成特定格式的文档,用于网站的模板引擎就会生成一个标准的HTML文档。
比如JSP、Velocity、Freemarker、Thymeleaf等等都是模板引擎,其中SpringBoot推荐的Thymeleaf语法更简单、功能更强大

Thymeleaf的使用

1.引入thymeleaf

首先引入依赖

<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>
		<dependency>
			<groupId>org.thymeleaf</groupId>
			<artifactId>thymeleaf-spring5</artifactId>
		</dependency>
		<dependency>
			<groupId>org.thymeleaf.extras</groupId>
			<artifactId>thymeleaf-extras-java8time</artifactId>
		</dependency>

修改一下thymeleaf的版本


<properties>
    <thymeleaf.version>3.0.2.RELEASE</thymeleaf.version>
    <thymeleaf-layout-dialect.version>2.1.1</thymeleaf-layout-dialect.version>
</properties>

thymeleaf是主程序版本
thymeleaf-layout-dialect是布局功能的支持程序
thymeleaf3主程序 对应layout2以上版本

2.Thymeleaf的使用&语法

在springboot的autoconfiguration包中有关于thymeleaf的配置
image.png

@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {

	private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
	//默认前缀
	public static final String DEFAULT_PREFIX = "classpath:/templates/";
	//默认后缀
	public static final String DEFAULT_SUFFIX = ".html";

只要把HTML页面放在classpath:/templates/下,thymeleaf就可以自动渲染

语法

  1. 导入thymeleaf命名空间
<html lang="en" xmlns:th="http://www.thymeleaf.org">
  1. 使用thymeleaf语法
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功</h1>
    <!--将div的文本内容设置为指定的值-->
    <div th:text="${hello}"></div>
</body>
</html>

(1) th:text :改变当前元素的文本内容
**th:任意html属性 来替换原属性**
2018-02-04_123955

(2) 表达式

Simple expressions(表达式语法):
Variable Expressions: ${...} 获取变量值
	1). 获取对象属性,调用方法
	2). 使用内置的基本对象
            #ctx : the context object.
            #vars: the context variables.
            #locale : the context locale.
            #request : (only in Web Contexts) the HttpServletRequest object.
            #response : (only in Web Contexts) the HttpServletResponse object.
            #session : (only in Web Contexts) the HttpSession object.
            #servletContext : (only in Web Contexts) the ServletContext object.
	    这些内置对象还有很多方法
	       ${param.foo} // Retrieves a String[] with the values of request parameter 'foo'
               ${param.size()}
               ${param.isEmpty()}
               ${param.containsKey('foo')}

	3). 内置工具对象
		#execInfo : 
		#messages : 
		#uris : 
		#conversions : 
		#dates : 
		#calendars : 
        	#numbers : 
        	#strings : 
        	#objects : 
        	#bools : 
        	#arrays : 
        	#lists : 
        	#sets : 
        	#maps : 
        	#aggregates : 
        	#ids : 


Selection Variable Expressions: *{...} 选择表达式:和$()功能上一致,有额外功能
	例如:用th:object="${session.user}"标记一个值,然后要调用的话可以直接用*{firstName}就可以调用user里的内容
Message Expressions: #{...} 获取国际化内容
Link URL Expressions: @{...} 定义url连接
	引入变量可以在里面用(键=${值})
	@{/order/details(orderId=${o.id})}
Fragment Expressions: ~{...}  片段引用表达式
	<div th:insert="~{commons :: main}">...</div>



Literals(字面量)
	Text literals: 'one text' , 'Another one!' ,…
	Number literals: 0 , 34 , 3.0 , 12.3 ,…
	Boolean literals: true , false
	Null literal: null
	Literal tokens: one , sometext , main ,…

Text operations:(文本操作)
	String concatenation: +
	Literal substitutions: |The name is 	${name}|

Arithmetic operations:(数学运算)
	Binary operators: + , - , * , / , %
	Minus sign (unary operator): -

Boolean operations:(布尔运算)
	Binary operators: and , or
	Boolean negation (unary operator): ! , not

Comparisons and equality:(比较运算)
	Comparators: > , < , >= , <= ( gt , lt , ge , le )
	Equality operators: == , != ( eq , ne )

Conditional operators:(条件运算)
	If-then: (if) ? (then)
	If-then-else: (if) ? (then) : (else)
	Default: (value) ?: (defaultvalue)

Special tokens:(特殊操作)
	No-Operation: _

行内写法:
th:text="" :[[]]
th:utext="" :[()]