Spring Boot--Thymeleaf模板引擎/静态页面

时间 2019-11-24

标签 spring boot thymeleaf 模板引擎静态页面栏目 Spring 繁體版

原文原文链接

1.Spring Boot对静态资源的映射规则

若是你并不了解SpringBoot的静态页面,请看个人Thymeleaf第一篇:html

这是 Thymeleaf(一) 的连接 : aaatao66.github.io/2019/05/26/…java

若是静态资源文件夹下有 index.html的话,直接访问localhost:8080的话,index就是欢迎页

使用本身的图标:git

在静态资源文件夹放一个 favicon.ico 的图标,springboot底层会自动调用这个为咱们的图标github

我找了个小叮当的图标web

效果:spring

自定义静态资源文件夹

在你的 yml/properties下添加:express

spring.resources.static-locations=classpath:/hello/,classpath:/carson/
复制代码

定义以后,原来默认的就不能够使用了springboot

2. 引入 Thymeleaf

SpringBoot推荐使用thymeleaf,由于语法简单,功能强大, 不推荐使用jsp,默认也不支持jspbash

<!-- 引入 thymeleaf 模板引擎-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
复制代码

新版本的Spring Boot会自动设置好版本,若是你是1.x的Spring Boot,可能要本身更改版本了session

3. Thymeleaf 使用&语法

源码:

@ConfigurationProperties(
    prefix = "spring.thymeleaf"
)
public class ThymeleafProperties {
    private static final Charset DEFAULT_ENCODING;
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    public static final String DEFAULT_SUFFIX = ".html";
    private boolean checkTemplate = true;
    private boolean checkTemplateLocation = true;
    
    // 下面是先后缀,也就是说只要放在 prefix 目录下,就能够被渲染了
    private String prefix = "classpath:/templates/";
    private String suffix = ".html";
复制代码

写一个 controller 方法:

@RequestMapping("nice")
    public String nice(){
        return "nice";
    }
复制代码

在 resources下的 templates目录下建立nice.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>这是 nice 标签</h1>
</body>
</html>
复制代码

启动程序,访问 localhost:8080/nice

使用:

1.html页面导入 thymeleaf 的名称空间

<html lang="en" xmlns:th="http://www.thymeleaf.org">
复制代码

2.使用thymeleaf语法

controller:

@RequestMapping("nice")
    public String nice(Map<String,Object> map){
        map.put("hello","你好");
        return "nice";
    }
复制代码

nice.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>这是 nice 标签</h1>
	<!--获取做用域的文本内容-->
<div th:text="${hello}"></div>
</body>
</html>
复制代码

语法规则

1.th:text; 改变当前元素里面的内容;

th: 任意html属性,来替换原生属性

HTML代码:

<div id="div01" class="mydiv" th:id="${hello}" th:class="${hello}" th:text="${hello}"></div>
复制代码

Spring Boot解析后的源代码:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>这是 nice 标签</h1>

<div id="你好" class="你好">你好</div>
</body>
</html>
复制代码

id 和 class都被替换了

属性优先级

表达式

具体参考: 官方文档

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
Selection Variable Expressions: *{...} 选择表达式: 和${}在功能上是同样的
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:
Page 17 of 104
No-Operation: _
复制代码

试验如下:

controller代码:

@RequestMapping("nice")
    public String nice(Map<String,Object> map){
        map.put("hello","<h1>你好<h1/>");
        map.put("users", Arrays.asList("zhangsan","lisi","wangwu"));
        return "nice";
    }
复制代码

html 代码

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>这是 nice 标签</h1>

<div id="div01" class="mydiv" th:id="${hello}" th:class="${hello}" th:text="${hello}"></div>
<hr/>
<div th:text="${hello}"></div>
<div th:utext="${hello}"></div>
<hr/>
<!-- th:each 每次遍历都会生成当前这个标签-->
<h4 th:text="${user}" th:each="user:${users}"></h4>
<hr/>
<h4>
    <span th:each="user:${users}">[[${user}]]</span>
</h4>
</body>
</html>
复制代码

显示结果为:

网页源代码:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>这是 nice 标签</h1>

<div id="&lt;h1&gt;你好&lt;h1/&gt;" class="&lt;h1&gt;你好&lt;h1/&gt;">&lt;h1&gt;你好&lt;h1/&gt;</div>
<hr/>
<div>&lt;h1&gt;你好&lt;h1/&gt;</div>
<div><h1>你好<h1/></div>
<hr/>
<!-- th:each 每次遍历都会生成当前这个标签-->
<h4>zhangsan</h4>
<h4>lisi</h4>
<h4>wangwu</h4>
<hr/>
<h4>
    <span>zhangsan</span><span>lisi</span><span>wangwu</span>
</h4>
</body>
</html>
复制代码

小总结:

<div th:text="${hello}"></div>
<div th:utext="${hello}"></div>
复制代码

th:text : 转义特殊字符,因此页面显示 <h1>你好</h1>

th:utext: 不转义特殊字符, 页面直接显示 h1标签大标题你好

th:each: 写在 h4 标签上,每次遍历都会产生一个新的 h4标签:

zhangsan

lisi

wangwu

而写在 span里产生了3个span标签:

zhangsan lisi wangwu

个人掘金: juejin.im/user/5d1873…

我的博客: aaatao66.github.io/

欢迎关注点赞~~ 我会陆续记录本身的学习记录~