thymeleaf_3.0.5_中文参考手册

1.Thymeleaf简介

1.1 Thymeleaf是什么

Thymeleaf是面向Web和独立环境的现代服务器端Java模板引擎，能够处理HTML，XML，JavaScript，CSS甚至纯文本。

Thymeleaf旨在提供一个优雅的、高度可维护的创建模板的方式。为了实现这一目标，Thymeleaf建立在自然模板的概念上，将其逻辑注入到模板文件中，不会影响模板设计原型。 这改善了设计的沟通，弥合了设计和开发团队之间的差距。

Thymeleaf从设计之初就遵循Web标准——特别是HTML5标准，如果需要，Thymeleaf允许您创建完全符合HTML5验证标准的模板。

1.2 Thymeleaf能处理哪些模版

开箱即用，Thymeleaf何可让处理六种类型的模板，每种类型的模板称为模板模式∶

∶HTML

●XML

●TEXT

● JAVASCRIPT

·CSS

● RAW

这六种模版模式包含两种标记模板模式（HTML和XML），三种文本模板模式（TEXT，JAVASCRIPT和CSS）和一个无操作模板模式（RAW）。

HTML模板模式将允许任何类型的HTML输入，包括HTML5，HTML 4和XHTML。Thymeleaf在html5非验证模式和验证模式下都能正确执行，并且在输出结果中最大程度的遵循模板代码/结构。

XML模板模式将允许XML输入。在这种情况下，代码预期形式良好-没有未关闭的标签，没有引用属性等，如果出现非法XML输入，解析器将抛出异常。请注意，Thymeleaf不会执行XML验证（针对DTD或XML架构）。

TEXT模板模式将允许对非标记特性的模板使用特殊语法。例如∶文本电子邮件或模板文档。请注意，HTML或XML模板也可以作为TEXT处理，在这种情况下，它们将不会被解析为标记，并且每个标签如∶DOCTYPE，注释等都将被视为纯文本。

JAVASCRIPT模板模式将允许在Thymeleaf应用程序中处理JavaScript文件。这意味着可以在JavaScript文件中像与HTML文件中一样的方式使用模型数据，但可以使用特定于JavaScript的集成，例如专门的转义或自然脚本。 JAVASCRIPT模板模式被认为是文本模式，因此使用与TEXT模板模式相同的特殊语法。

CSS模板模式将允许处理涉及Thymeleaf应用程序的CSS文件。与JAVASCRIPT模式类似，CSS模板模式也是文本模式，并使用TEXT模板模式下的特殊处理语法。

RAW模板模式根本不会处理模板。它用于将未经修改的资源（文件，URL响应等））插入正在处理的模板中。例如，HTML格式的外部不受控制的资源可以包含在应用程序模板中，安全地知道这些资源可能包含的任何Thymeleaf代码将不会被执行。

1.3 Thymeleaf标准方言

Thymeleaf是一个扩展性很强的模板引擎（实际上它可以称为模板引擎框架），Thyme Leaf允许您自定义模板，并且很好的处理该模版的细节。将一些逻辑应用于标记组件（标签，某些文本，注释或只有占位符）的一个对象被称为处理器，通常这些处理器的集合以及—些额外的组件就组成了Thymeleaf方言。 开箱即用，Thymeleaf的核心库提供了一种称为标准方言的方言，这对大多数用户来说应该是足够的。

请注意，方言实际上可能不包含处理器，并且完全由其他类型的组件构成，但处理器绝对是最常见的用例。

本教程涵盖Thyme Leaf的标准方言。 您将在后面章节中的每个属性和语法功能都由Thyme Leaf标准方言定义，即使没有明确提及。

当然，如果用户希望在使用标准方言库的高级功能的同时还想定义自己的处理逻辑，您也可以创建自己的方言（甚至扩展标准的方言）。您 也可以将Thymeleaf配置为一次使用几种方言。

官方的thymeleaf-spring3和thymeleaf-spring4的整合包里都定义了一种称为"spring标准方言"的方言，该方言与"Thyme Leaf标准方言"大致相同，但是对于Spring框架中的某些功能（例如，通过使用SpringEL表达式代替OGNL表达式）做了一些简单的调整。 所以如果你是一个Spring MVC用户，使用ThymeLeaf拼并不会浪费你的时间，因为你在这里学到的所有东西都将可以应用到你的Spring应用程序中。

ThymeLeaf标准方言中的大多数处理器都是是属性处理器。 这样，即使在模版未被处理之前，浏览器也可以正确地显示HTML模板文件，因为浏览器将简单地忽略其不识别的属性。 例如，像下面这段JSP模版的代码片段就不能在模版被解析之前通过浏览器直接显示了∶

1.3 Thymeleaf标准方言

Thymeleaf是一个扩展性很强的模板引擎（实际上它可以称为模板引擎框架），Thyme Leaf允许您自定义模板，并且很好的处理该模版的细节。将一些逻辑应用于标记组件（标签，某些文本，注释或只有占位符）的一个对象被称为处理器，通常这些处理器的集合以及—些额外的组件就组成了Thymeleaf方言。 开箱即用，Thymeleaf的核心库提供了一种称为标准方言的方言，这对大多数用户来说应该是足够的。

请注意，方言实际上可能不包含处理器，并且完全由其他类型的组件构成，但处理器绝对是最常见的用例。

本教程涵盖Thyme Leaf的标准方言。 您将在后面章节中的每个属性和语法功能都由Thyme Leaf标准方言定义，即使没有明确提及。

当然，如果用户希望在使用标准方言库的高级功能的同时还想定义自己的处理逻辑，您也可以创建自己的方言（甚至扩展标准的方言）。您 也可以将Thymeleaf配置为一次使用几种方言。

官方的thymeleaf-spring3和thymeleaf-spring4的整合包里都定义了一种称为"spring标准方言"的方言，该方言与"Thyme Leaf标准方言"大致相同，但是对于Spring框架中的某些功能（例如，通过使用SpringEL表达式代替OGNL表达式）做了一些简单的调整。 所以如果你是一个Spring MVC用户，使用ThymeLeaf拼并不会浪费你的时间，因为你在这里学到的所有东西都将可以应用到你的Spring应用程序中。

ThymeLeaf标准方言中的大多数处理器都是是属性处理器。 这样，即使在模版未被处理之前，浏览器也可以正确地显示HTML模板文件，因为浏览器将简单地忽略其不识别的属性。 例如，像下面这段JSP模版的代码片段就不能在模版被解析之前通过浏览器直接显示了∶

百度网盘链接：https://pan.baidu.com/s/1hbKMh6PUX5mtVcDbGGHsWQ

提取码：5ctj