Thymeleaf模板引擎的使用&语法

1.Thymeleaf的默认规则:

@ConfigurationProperties(
    prefix = "spring.thymeleaf"
)
public class ThymeleafProperties {
    private static final Charset DEFAULT_ENCODING = Charset.forName("UTF-8");
    private static final MimeType DEFAULT_CONTENT_TYPE = MimeType.valueOf("text/html");
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    public static final String DEFAULT_SUFFIX = ".html";
    .....
}

创建一个控制器类和一个简单的html页面

package com.myweb.springboot.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Controller
public class HelloController {

    @RequestMapping("success")
    public String success(){
        return "success" ;
    }
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功!</h1>
</body>
</html>

访问: localhost:8080/success

只要把HTML页面放在 classpath:/templates/ , thymeleaf模板引擎就能自动渲染;

2.导入thymeleaf的名称空间 : xmlns:th="http://www.thymeleaf.org" ,导入后会有语法提示

3.使用thymeleaf语法 : ${}

忽略IDEA里面"${hello}"下的的红线

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功!</h1>
    <!--th:text 将div里面的文本内容设置为后台对应的值-->
    <div th:text="${hello}">这是一个div</div>
</body>
</html>

4.语法规则:

th : 任意html属性 : 替换原生属性的值

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功!</h1>
    <!--th:text 将div里面的文本内容设置为后台对应的值-->
    <div id="id1" class="classA" th:id="${hello}" th:class="${hello}" th:text="${hello}">这是一个div</div>
</body>
</html>

网页源码:

thymeleaf使用手册:

5.表达式:

Simple expressions(表达式语法):
Variable Expressions(获取变量值OGNL): ${...}  
      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.
      3.内置的一些工具对象:
        #execInfo : information about the template being processed.
        #messages : methods for obtaining externalized messages inside variables                                                         expressions, in the same way as they
        would be obtained using #{…} syntax.
        #uris : methods for escaping parts of URLs/URIs
        #conversions : methods for executing the configured conversion service (if any).
        #dates : methods for java.util.Date objects: formatting, component extraction, etc.
        #calendars : analogous to #dates , but for java.util.Calendar objects.
        #numbers : methods for formatting numeric objects.
        #strings : methods for String objects: contains, startsWith,prepending/appending,etc.
        #objects : methods for objects in general.
        #bools : methods for boolean evaluation.
        #arrays : methods for arrays.
        #lists : methods for lists.
        #sets : methods for sets.
        #maps : methods for maps.
        #aggregates : methods for creating aggregates on arrays or collections.
        #ids : methods for dealing with id attributes that might be repeated (for example, as a result of an iteration).

Selection Variable Expressions(选择表达式): *{...}
        1.和${}在功能上一样,补充功能:配合 th:object 进行使用
Message Expressions(获取国际化内容): #{...}
Link URL Expressions(定义url): @{...}
Fragment Expressions(片段引用表达式): ~{...}

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(没有操作): _

详情参见上方pdf文档!

举个栗子:

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功!</h1>
    <!--th:text 将div里面的文本内容设置为后台对应的值-->
    <!--<div id="id1" class="classA" th:id="${hello}" th:class="${hello}" th:text="${hello}">这是一个div</div>-->
    <hr/>
    <!--th:text转义特殊字符-->
    <div th:text="${hello}"></div>
    <!--th:utext不转义特殊字符-->
    <div th:utext="${hello}"></div>
    <hr/>
    <!--th:each每次都会生成当前这个标签-->
    <!--3个h4-->
    <h4 th:text="${user}" th:each="user:${users}"></h4>
    <hr/>
    <h4>
        <span th:each="user:${users}"> [[${user}]] </span>
    </h4>
</body>
</html>

行内写法: [[]] 和 [()]

[[]] = th:text : 转义特殊字符

[()] = th:utext : 不会转义特殊字符

Thymeleaf模板引擎的使用&语法

猜你喜欢