Thymeleaf是一种基于Java的模板引擎,可以处理和生成HTML、XML、JavaScript、CSS和文本。它支持在Web和非Web环境下运行,并且与Spring MVC等框架集成良好。Thymeleaf语法简单直观,易于学习和使用。
Thymeleaf的语法主要包括以下几个方面:
- 表达式语言(Expression Language,简称EL):EL用于访问Java对象和集合的属性、方法和变量。它类似于JSP和JSF中的EL表达式。
- 变量和属性:在Thymeleaf模板中,可以使用
th:
标签来定义变量和属性。变量名和属性名以th:
开头,后面跟着变量名或属性名。例如,th:each="item : ${items}"
定义了一个名为item
的变量,并将其值设置为${items}
表达式的结果。 - 指令:Thymeleaf提供了多种指令来控制模板的行为。例如,
<th:block>
指令可以用于定义一个可重复使用的区域,可以多次渲染同一模板中的不同数据。其他指令包括<th:if>、<th:each>、<th:with>
等。 - 条件语句:Thymeleaf支持使用
<th:if>
标签来创建条件语句。例如,<th:if test="${condition}">Content</th:if>
将在条件为真时渲染Content
。 - 国际化:Thymeleaf支持国际化和本地化,可以使用
th:text
标签来引用国际化的文本。例如,<th:text="#{message.hello}">Hello</th:text>
将引用名为message.hello
的国际化和本地化的文本。 - URL和链接:Thymeleaf提供了
th:href
标签来生成URL和链接。例如,<th:href="@{/some/path}">Link text</th:href>
将生成一个指向/some/path
路径的链接。 - HTML标签和属性:Thymeleaf支持使用HTML标签和属性来渲染页面。同时,它还提供了一些额外的属性来增强HTML标签的功能。例如,可以使用
th:class
标签来设置CSS类名。
Thymeleaf是一种Java模板引擎,可以用来在Web应用程序中生成HTML页面。以下是Thymeleaf的整合和使用方法:
1.引入依赖:在使用Thymeleaf之前,需要在项目中添加Thymeleaf的依赖。可以通过Maven或Gradle等构建工具来添加依赖。以Maven为例,在pom.xml文件中添加以下依赖:,例如:
xml:
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf-spring5</artifactId>
<version>3.0.11.RELEASE</version>
</dependency>
2.配置视图解析器:在Spring Boot项目的配置类中,创建一个Thymeleaf视图解析器。这个视图解析器将Thymeleaf引擎与Spring MVC集成在一起。在Spring应用程序的配置文件中,添加Thymeleaf视图解析器的配置项,例如:
@Bean
public ViewResolver viewResolver() {
ThymeleafViewResolver resolver = new ThymeleafViewResolver();
resolver.setTemplateEngine(templateEngine());
resolver.setCharacterEncoding("UTF-8");
return resolver;
}
@Bean
public ITemplateEngine templateEngine() {
SpringTemplateEngine engine = new SpringTemplateEngine();
engine.setEnableSpringELCompiler(true);
engine.setTemplateResolver(templateResolver());
return engine;
}
@Bean
public ITemplateResolver templateResolver() {
ServletContextTemplateResolver resolver = new ServletContextTemplateResolver();
resolver.setPrefix("/WEB-INF/views/");
resolver.setSuffix(".html");
resolver.setTemplateMode("HTML5");
resolver.setCharacterEncoding("UTF-8");
return resolver;
}
3.在控制器中返回Thymeleaf模板名称:在控制器的方法中,返回一个包含模板名称的字符串,创建以.html
结尾的HTML模板文件,并使用Thymeleaf语法来引用Java对象和表达式。例如,可以使用th:text="${title}"
来引用Java对象中的title
属性。在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以静态地运行;当有数据返回到页面时,Thymeleaf 标签会动态地替换掉静态内容,使页面动态显示。例如:
@RequestMapping("/hello")
public String hello(Model model) {
model.addAttribute("message", "Hello Thymeleaf!");
return "hello";
}
4.在模板中使用Thymeleaf表达式:在HTML模板中,可以使用Thymeleaf表达式来访问模型中的数据,例如:
<html>
<head>
<title>Hello Thymeleaf</title>
</head>
<body>
<h1 th:text="${message}">Hello Thymeleaf!</h1>
</body>
</html>
以上是Thymeleaf的整合和使用方法,通过使用Thymeleaf可以方便地生成动态的HTML页面。
二、Thymeleaf的使用
- 创建模板
在src/main/resources/templates目录下创建模板文件,例如hello.html:
<!DOCTYPE html>
<html>
<head>
<title>Hello World</title>
</head>
<body>
<h1 th:text="${message}">Hello World</h1>
</body>
</html>
其中,th:text="${message}"表示将模板中的message变量替换为控制器中传来的值。
2.创建控制器
在Java代码中创建控制器,例如HelloController:
@Controller
public class HelloController {
@RequestMapping("/hello")
public String hello(Model model) {
model.addAttribute("message", "Hello Thymeleaf");
return "hello";
}
}
3.页面标签的使用
在Thymeleaf模板文件中,可以使用各种标签来渲染数据和执行逻辑操作。以下是一些常用的标签:
- th:each:循环遍历集合或数组中的元素。
- th:if:根据条件判断是否显示某个元素。例如:
<div th:if="${condition}">This is shown if condition is true</div>
。 - th:switch:根据条件判断切换不同的元素。例如:
<div th:switch="${condition}">Case 1<div th:when="true">This is shown if condition is true</div>Case 2<div th:when="false">This is shown if condition is false</div></div>
。 - th:each嵌套th:if:在循环中根据条件判断是否显示某个元素。
注意,如果要在非Web环境下使用Thymeleaf,例如在Java SE环境中,可以创建一个TemplateEngine
实例并使用它来处理模板。此外,使用Thymeleaf时,可以通过设置缓存属性来控制缓存行为。例如,将spring.thymeleaf.cache
设置为false
可以关闭模板缓存,以便在每次修改模板时都能即时看到更改。
总之,通过以上步骤,可以成功地整合和使用Thymeleaf模板引擎与Spring Boot框架。Thymeleaf提供了丰富的功能来访问Java对象和集合的属性、方法和变量,以及控制模板的行为和渲染页面。同时,它还支持在Web和非Web环境下运行,使得在Java项目中创建动态Web页面变得更加容易和高效。