这是 th:text 属性的默认行为。如果我们希望 Thymeleaf 保留 HTML 标签而不转义它们，需要使用不同的属性：th:utext（用于"未转义的文本"）：

Welcome to our grocery store!

这将输出我们想要的消息：

Welcome to our fantastic grocery store!

# 使用和显示变量 现在让我们为主页添加更多内容。例如，我们可能希望在欢迎信息下方显示日期：

Welcome to our fantastic grocery store!

Today is: 12 july 2010

首先，我们需要修改控制器，将日期作为上下文变量添加：

public void process(

final IWebExchange webExchange,

final ITemplateEngine templateEngine,

final Writer writer)

throws Exception {

SimpleDateFormat dateFormat = new SimpleDateFormat("dd MMMM yyyy");

Calendar cal = Calendar.getInstance();

WebContext ctx = new WebContext(webExchange, webExchange.getLocale());

ctx.setVariable("today", dateFormat.format(cal.getTime()));

templateEngine.process("home", ctx, writer);

}

我们在上下文中添加了一个名为 today 的 String 变量，现在可以在模板中显示它：

Welcome to our grocery store!

Today is: 13 February 2011

正如你所看到的，我们仍然使用 th:text 属性来完成这项工作（这是正确的，因为我们想要替换标签的主体），但这次语法有点不同，我们使用的是 ${...} 表达式值，而不是 #{...} 表达式值。这是一个变量表达式，它包含一种称为 OGNL（对象图导航语言）的表达式，该表达式会在上下文变量映射上执行。

${today} 表达式简单地表示"获取名为 today 的变量"，但这些表达式可能更复杂（例如 ${user.name} 表示"获取名为 user 的变量，并调用其 getName() 方法"）。

属性值中有很多可能性：消息、变量表达式……还有很多。下一章将展示所有这些可能性。

# 4 标准表达式语法 我们暂时中断虚拟杂货店的开发，来学习 Thymeleaf 标准方言中最重要的部分之一：Thymeleaf 标准表达式语法。

我们已经看到了两种用这种语法表示的有效属性值：消息表达式和变量表达式：

Welcome to our grocery store!

Today is: 13 february 2011

但还有更多类型的表达式，以及已知表达式的更多有趣细节。

首先，让我们快速总结一下标准表达式的特性：

简单表达式：

变量表达式：${...} 选择变量表达式：*{...} 消息表达式：#{...} 链接 URL 表达式：@{...} 片段表达式：~{...} 字面量：

文本字面量：'one text', 'Another one!',… 数字字面量：0, 34, 3.0, 12.3,… 布尔字面量：true, false Null 字面量：null 字面量标记：one, sometext, main,… 文本操作：

字符串连接：+ 字面量替换：|The name is ${name}| 算术操作：

二元运算符：+, -, *, /, % 负号（一元运算符）：- 布尔操作：

二元运算符：and, or 布尔否定（一元运算符）：!, not 比较和相等：

比较器：>, <, >=, <= (gt, lt, ge, le) 相等运算符：==, != (eq, ne) 条件运算符：

If-then：(if) ? (then) If-then-else：(if) ? (then) : (else) 默认值：(value) ?: (defaultvalue) 特殊标记：

无操作：_ 所有这些特性都可以组合和嵌套：

'User is of type ' + (${user.isAdmin()} ? 'Administrator' : (${user.type} ?: 'Unknown'))

# 4.1 消息 正如我们已经知道的，#{...} 消息表达式允许我们将以下内容关联起来：

Welcome to our grocery store!

……到以下内容：

home.welcome=¡Bienvenido a nuestra tienda de comestibles!

但我们还没有考虑到一个方面：如果消息文本不是完全静态的怎么办？例如，如果应用程序知道当前访问网站的用户是谁，并且我们想通过名字来问候他们？

¡Bienvenido a nuestra tienda de comestibles, John Apricot!

这意味着我们需要为消息添加一个参数。就像这样：

home.welcome=¡Bienvenido a nuestra tienda de comestibles, {0}!

参数根据 java.text.MessageFormat 标准语法指定，这意味着你可以按照 java.text.* 包中的 API 文档格式化数字和日期。

为了给参数指定一个值，并且给定一个名为 user 的 HTTP 会话属性，我们可以这样做：

Welcome to our grocery store, Sebastian Pepper!

注意：这里使用 th:utext 意味着格式化后的消息不会被转义。此示例假设 user.name 已经被转义。

可以指定多个参数，用逗号分隔。

消息键本身也可以来自变量：

Welcome to our grocery store, Sebastian Pepper!

# 4.2 变量 我们已经提到，${...} 表达式实际上是 OGNL（对象图导航语言）表达式，在上下文包含的变量映射上执行。

有关 OGNL 语法和功能的详细信息，你应该阅读 OGNL 语言指南 (opens new window)。

在启用 Spring MVC 的应用程序中，OGNL 将被 SpringEL 替换，但其语法与 OGNL 非常相似（实际上，在大多数常见情况下完全相同）。

从 OGNL 的语法中，我们知道以下表达式：

Today is: 13 february 2011.

……实际上等同于：

ctx.getVariable("today");

但 OGNL 允许我们创建更强大的表达式，这就是以下内容：

Welcome to our grocery store, Sebastian Pepper!

……通过执行以下操作获取用户名：

((User) ctx.getVariable("session").get("user")).getName();

但 getter 方法导航只是 OGNL 的特性之一。让我们看看更多：

/*

* 使用点（.）访问属性。等同于调用属性 getter。

*/

${person.father.name}

/*

* 也可以使用方括号（[]）访问属性，并将属性名称作为变量或单引号之间的字符串写入。

*/

${person['father']['name']}

/*

* 如果对象是映射，点语法和方括号语法都等同于调用其 get(...) 方法。

*/

${countriesByCode.ES}

${personsByName['Stephen Zucchini'].age}

/*

* 数组或集合的索引访问也使用方括号，索引不带引号。

*/

${personsArray[0].name}

/*

* 可以调用方法，甚至可以带参数。

*/

${person.createCompleteName()}

${person.createCompleteNameWithSeparator('-')}

# 表达式基本对象 在上下文变量上计算 OGNL 表达式时，一些对象会被提供给表达式以增加灵活性。这些对象以 # 符号开头引用：

#ctx：上下文对象。 #vars：上下文变量。 #locale：上下文语言环境。 所以我们可以这样做：

Established locale country: US.

你可以在 附录 A 中查看这些对象的完整参考。

# 表达式实用对象 除了这些基本对象外，Thymeleaf 还提供了一组实用对象，帮助我们在表达式中执行常见任务。

#execInfo：有关正在处理的模板的信息。 #messages：用于在变量表达式中获取外部化消息的方法，与使用 #{...} 语法相同。 #uris：用于转义 URL/URI 部分的方法。 #conversions：用于执行配置的转换服务（如果有）的方法。 #dates：用于 java.util.Date 对象的方法：格式化、组件提取等。 #calendars：类似于 #dates，但用于 java.util.Calendar 对象。 #temporals：用于在 JDK8+ 中使用 java.time API 处理日期和时间。 #numbers：用于格式化数字对象的方法。 #strings：用于 String 对象的方法：包含、以…开头、前置/追加等。 #objects：用于一般对象的方法。 #bools：用于布尔评估的方法。 #arrays：用于数组的方法。 #lists：用于列表的方法。 #sets：用于集合的方法。 #maps：用于映射的方法。 #aggregates：用于在数组或集合上创建聚合的方法。 #ids：用于处理可能重复的 id 属性的方法（例如，作为迭代的结果）。 你可以在 附录 B 中查看这些实用对象提供的功能。

# 在主页中重新格式化日期 现在我们知道了这些实用对象，可以使用它们来改变在主页中显示日期的方式。不是在 HomeController 中这样做：

SimpleDateFormat dateFormat = new SimpleDateFormat("dd MMMM yyyy");

Calendar cal = Calendar.getInstance();

WebContext ctx = new WebContext(webExchange, webExchange.getLocale());

ctx.setVariable("today", dateFormat.format(cal.getTime()));

templateEngine.process("home", ctx, writer);

……我们可以这样做：

WebContext ctx = new WebContext(webExchange, webExchange.getLocale());

ctx.setVariable("today", Calendar.getInstance());

templateEngine.process("home", ctx, writer);

……然后在视图层执行日期格式化：

Today is: 13 May 2011

# 4.3 选择表达式（星号语法） 变量表达式不仅可以写成 ${...}，还可以写成 *{...}。

但有一个重要的区别：星号语法在选定对象上计算表达式，而不是在整个上下文上。也就是说，只要没有选定对象，美元和星号语法完全相同。

那么什么是选定对象？使用 th:object 属性的表达式的结果。让我们在用户配置文件（userprofile.html）页面中使用：

这完全等同于：

当然，美元和星号语法可以混合使用：

当选定对象存在时，选定对象也会作为 #object 表达式变量提供给美元表达式：

如前所述，如果没有执行对象选择，美元和星号语法是等价的。

# 4.4 链接 URL 由于 URL 在 Web 应用程序模板中的重要性，Thymeleaf 标准方言为它们提供了一种特殊的语法，即 @ 语法：@{...}。

有不同类型的 URL：

绝对 URL：http://www.thymeleaf.org 相对 URL，可以是：

页面相对：user/login.html 上下文相对：/itemdetails?id=3（服务器上的上下文名称将自动添加） 服务器相对：~/billing/processInvoice（允许调用同一服务器上另一个上下文（= 应用程序）中的 URL） 协议相对 URL：//code.jquery.com/jquery-2.0.3.min.js 这些表达式的实际处理及其转换为将输出的 URL 由注册到正在使用的 ITemplateEngine 对象的 org.thymeleaf.linkbuilder.ILinkBuilder 接口实现完成。

默认情况下，注册了此接口的单个实现，即 org.thymeleaf.linkbuilder.StandardLinkBuilder 类，它足以满足基于 Servlet API 的离线（非 Web）和 Web 场景。其他场景（如与非 ServletAPI Web 框架的集成）可能需要特定的链接构建器接口实现。

让我们使用这个新语法。了解一下 th:href 属性：

th:href="@{http://localhost:8080/gtvg/order/details(orderId=${o.id})}">view

view

view

这里有一些需要注意的事项：

th:href 是一个修饰属性：一旦处理，它会计算要使用的链接 URL 并将该值设置为 标签的 href 属性。 我们允许使用表达式作为 URL 参数（如 orderId=${o.id}）。所需的 URL 参数编码操作也会自动执行。 如果需要多个参数，这些参数将用逗号分隔：@{/order/process(execId=${execId},execType='FAST')} URL 路径中也允许使用变量模板：@{/order/{orderId}/details(orderId=${orderId})} 以 / 开头的相对 URL（例如：/order/details）将自动添加应用程序上下文名称。 如果未启用 cookie 或尚未知道，可能会为相对 URL 添加 ";jsessionid=..." 后缀，以便保留会话。这称为 URL 重写，Thymeleaf 允许你通过使用 Servlet API 的 response.encodeURL(...) 机制为每个 URL 插入自己的重写过滤器。 th:href 属性允许我们（可选地）在模板中拥有一个有效的静态 href 属性，以便模板链接在直接打开以进行原型设计时仍然可以导航。 与消息语法（#{...}）一样，URL 基础也可以是计算另一个表达式的结果：

view

view

# 主页的菜单 现在我们知道如何创建链接 URL，那么在主页中添加一个小菜单来链接到网站中的其他页面呢？

Please select an option

1. Product List
2. Order List
3. Subscribe to our Newsletter
4. See User Profile

# 服务器根相对 URL 可以使用额外的语法来创建服务器根相对（而不是上下文根相对）URL，以便链接到同一服务器中的不同上下文。这些 URL 指定为 @{~/path/to/something}。

# 4.5 片段 片段表达式是一种表示标记片段并在模板间移动它们的简单方法。这允许我们复制它们，将它们作为参数传递给其他模板等。

最常见的用途是使用 th:insert 或 th:replace 进行片段插入（稍后会在有关模板布局的部分中详细介绍）：

但它们可以像任何其他变量一样在任何地方使用：

在本教程的后面部分，有一个专门介绍模板布局的部分，包括对片段表达式的更深入解释。

# 4.6 字面量 # 文本字面量 文本字面量只是用单引号括起来的字符串。它们可以包含任何字符，但你应该使用 \' 转义其中的任何单引号。

Now you are looking at a template file.

# 数字字面量 数字字面量就是数字。

The year is 1492.

In two years, it will be 1494.

# 布尔字面量 布尔字面量是 true 和 false。例如：

在这个例子中，== false 写在括号外，因此由 Thymeleaf 处理。如果写在括号内，则由 OGNL/SpringEL 引擎处理：

# Null 字面量 null 字面量也可以使用：

# 字面量标记 数字、布尔值和空值字面量实际上是字面量标记的一种特殊情况。

这些标记在标准表达式中允许进行一些简化。它们的工作方式与文本字面量（'...'）完全相同，但它们只允许字母（A-Z 和 a-z）、数字（0-9）、括号（[ 和 ]）、点（.）、连字符（-）和下划线（_）。所以不允许有空格、逗号等。

好的部分是什么？标记不需要任何引号包围。所以我们可以这样做：

而不是：

# 4.7 文本拼接 文本，无论是字面量还是计算变量或消息表达式的结果，都可以使用 + 操作符轻松拼接：

# 4.8 字面量替换 字面量替换允许格式化包含变量值的字符串，而无需使用 '...' + '...' 进行拼接。

这些替换必须用竖线（|）括起来，例如：

这等同于：

字面量替换可以与其他类型的表达式结合使用：

注意：只有变量/消息表达式（${...}、*{...}、#{...}）允许在 |...| 字面量替换中使用。不允许其他字面量（'...'）、布尔/数字标记、条件表达式等。

# 4.9 算术操作 一些算术操作也是可用的：+、-、*、/ 和 %。

请注意，这些操作符也可以在 OGNL 变量表达式中使用（在这种情况下将由 OGNL 而不是 Thymeleaf 标准表达式引擎执行）：

注意，这些操作符有一些文本别名：div（/）、mod（%）。

# 4.10 比较器和相等 表达式中的值可以使用 >、<、>= 和 <= 符号进行比较，== 和 != 运算符可用于检查相等性（或不等性）。请注意，XML 规定 < 和 > 符号不应在属性值中使用，因此应替换为 < 和 >。

更简单的替代方案是使用这些操作符的文本别名：gt（>）、lt（<）、ge（>=）、le（<=）、not（!）。还有 eq（==）、neq/ne（!=）。

# 4.11 条件表达式 条件表达式用于根据条件（本身是另一个表达式）的计算结果来计算两个表达式中的一个。

让我们看一个示例片段（引入另一个属性修饰符，th:class）：

...

条件表达式的所有三个部分（条件、then 和 else）本身都是表达式，这意味着它们可以是变量（${...}、*{...}）、消息（#{...}）、URL（@{...}）或字面量（'...'）。

条件表达式也可以使用括号嵌套：

...

else 表达式也可以省略，在这种情况下，如果条件为假，则返回空值：

...

# 4.12 默认表达式（Elvis 操作符） 默认表达式是一种没有 then 部分的特殊条件值。它等同于 Groovy 等语言中的 Elvis 操作符，允许你指定两个表达式：如果第一个表达式计算为非空值，则使用它；否则使用第二个表达式。

让我们在用户资料页面中看看它的作用：

如你所见，操作符是 ?:，我们在这里用它来指定年龄的默认值（在此例中是一个字面量值），仅当 *{age} 的计算结果为 null 时。因此，这等同于：

Age: 27.

与条件值一样，它们可以包含括号中的嵌套表达式：

Name:

Sebastian

# 4.13 无操作标记 无操作标记由下划线符号（_）表示。

这个标记的含义是指定表达式的结果应为 无操作，即表现得好像可处理属性（例如 th:text）根本不存在一样。

其中一个应用场景是，这允许开发人员使用原型文本作为默认值。例如，而不是：

...

……我们可以直接使用 "no user authenticated" 作为原型文本，从而使代码更简洁且在设计上更通用：

no user authenticated

# 4.14 数据转换/格式化 Thymeleaf 为变量（${...}）和选择（*{...}）表达式定义了一种 双括号 语法，允许我们通过配置的 转换服务 应用 数据转换。

它基本上是这样的：

...

注意到双括号了吗？${​{ ... }}。这指示 Thymeleaf 将 user.lastAccessDate 表达式的结果传递给 转换服务，并要求它在写入结果之前执行 格式化操作（转换为 String）。

假设 user.lastAccessDate 的类型为 java.util.Calendar，如果已注册 转换服务（IStandardConversionService 的实现）并包含 Calendar -> String 的有效转换，则会应用该转换。

IStandardConversionService 的默认实现（StandardConversionService 类）只是对任何转换为 String 的对象执行 .toString()。有关如何注册自定义 转换服务 实现的更多信息，请参阅 更多配置 部分。

官方的 thymeleaf-spring5 和 thymeleaf-spring6 集成包将 Thymeleaf 的转换服务机制与 Spring 的 Conversion Service 基础架构无缝集成，因此 Spring 配置中声明的转换服务和格式化程序将自动提供给 ${​{ ... }} 和 *{​{ ... }} 表达式。

# 4.15 预处理 除了所有这些表达式处理功能外，Thymeleaf 还具有 预处理 表达式的功能。

预处理是在正常表达式执行之前对表达式执行的，允许修改最终要执行的表达式。

预处理的表达式与普通表达式完全相同，但用双下划线符号括起来（如 __${expression}__）。

让我们假设有一个 Messages_fr.properties 条目，其中包含调用特定于语言的静态方法的 OGNL 表达式，例如：

article.text=@myapp.translator.Translator@translateToFrench({0})

……和一个 Messages_es.properties 的等效条目：

article.text=@myapp.translator.Translator@translateToSpanish({0})

我们可以创建一段标记，根据语言环境计算一个表达式或另一个表达式。为此，我们首先选择表达式（通过预处理），然后让 Thymeleaf 执行它：

Some text here...

请注意，法语语言环境的预处理步骤会创建以下等效内容：

Some text here...

预处理字符串 __ 可以在属性中使用 \_\_ 进行转义。

# 5 设置属性值 本章将解释如何在标记中设置（或修改）属性的值。

# 5.1 设置任何属性的值 假设我们的网站发布了一则新闻通讯，我们希望用户能够订阅它，因此我们创建了一个 /WEB-INF/templates/subscribe.html 模板，并添加了一个表单：

与 Thymeleaf 一样，这个模板最初更像是一个静态原型，而不是一个 Web 应用程序的模板。首先，表单中的 action 属性静态链接到模板文件本身，因此没有地方进行有用的 URL 重写。其次，提交按钮中的 value 属性使其显示英文文本，但我们希望它是国际化的。

因此，我们引入了 th:attr 属性，它能够更改其所在标签的属性值：

概念非常简单：th:attr 只需接受一个表达式，该表达式会将值分配给属性。创建相应的控制器和消息文件后，处理此文件的结果是：

除了新的属性值之外，你还可以看到应用程序上下文名称已自动前缀到 URL 基础 /gtvg/subscribe，如前一章所述。

但如果我们想一次设置多个属性怎么办？XML 规则不允许你在标签中两次设置一个属性，因此 th:attr 会接受一个逗号分隔的赋值列表，例如：

th:attr="src=@{/images/gtvglogo.png},title=#{logo},alt=#{logo}" />

给定所需的消息文件后，这会输出：

# 5.2 设置特定属性的值 到目前为止，你可能会想到下面这样的代码：

这段代码在标记中看起来相当丑陋。在属性值中指定赋值可能非常实用，但如果你必须一直这样做，这并不是创建模板的最优雅方式。

Thymeleaf 同意你的观点，这就是为什么在模板中很少使用 th:attr。通常情况下，你会使用其他 th:* 属性，它们的任务是设置特定的标签属性（而不像 th:attr 那样只设置任何属性）。

例如，要设置 value 属性，请使用 th:value：

这看起来好多了！让我们尝试对 form 标签中的 action 属性做同样的操作：

还记得我们之前在 home.html 中放置的那些 th:href 吗？它们正是这种类型的属性：

有许多类似的属性，每个属性都针对特定的 HTML5 属性。

# 5.3 一次设置多个值 有两个相当特殊的属性叫做 th:alt-title 和 th:lang-xmllang，它们可以同时将两个属性设置为相同的值。具体来说：

th:alt-title 将设置 alt 和 title。 th:lang-xmllang 将设置 lang 和 xml:lang。 对于我们的 GTVG 主页，这将允许我们替换以下代码：

th:attr="src=@{/images/gtvglogo.png},title=#{logo},alt=#{logo}" />

或者这个等效的代码：

th:src="@{/images/gtvglogo.png}" th:title="#{logo}" th:alt="#{logo}" />

替换为以下代码：

th:src="@{/images/gtvglogo.png}" th:alt-title="#{logo}" />

# 5.4 追加和前置 Thymeleaf 还提供了 th:attrappend 和 th:attrprepend 属性，它们会将计算结果附加（后缀）或前置（前缀）到现有属性值。

例如，你可能希望将 CSS 类的名称存储在一个上下文变量中，以便添加到按钮中，因为要使用的特定 CSS 类取决于用户之前执行的操作：

如果你使用 cssStyle 变量设置为 "warning" 处理此模板，你会得到：

标准方言中还有两个特定的"追加属性"：th:classappend 和 th:styleappend 属性，它们用于向元素添加 CSS 类或样式片段，而不覆盖现有的类或样式：

# 5.5 固定值布尔属性 HTML 有布尔属性的概念，这些属性没有值，它们的存在意味着值为 "true"。在 XHTML 中，这些属性只接受一个值，即它们本身。

例如，checked：

标准方言包括允许你通过计算条件来设置这些属性的属性，因此，如果计算为 true，则会将该属性设置为其固定值，如果计算为 false，则不设置该属性：

标准方言中存在的固定值布尔属性如下：

th:async th:autofocus th:autoplay th:checked th:controls th:declare th:default th:defer th:disabled th:formnovalidate th:hidden th:ismap th:loop th:multiple th:novalidate th:nowrap th:open th:pubdate th:readonly th:required th:reversed th:scoped th:seamless th:selected # 5.6 设置任何属性的值（默认属性处理器） Thymeleaf 提供了一个默认属性处理器，它允许我们设置任何属性的值，即使在标准方言中没有定义特定的 th:* 处理器。

例如：

...

会产生：

...

# 5.7 支持 HTML5 友好的属性和元素名称 还可以使用完全不同的语法以更符合 HTML5 的方式将处理器应用于模板。

data-{prefix}-{name} 语法是在 HTML5 中编写自定义属性的标准方式，无需开发人员使用任何命名空间名称，如 th:*。Thymeleaf 使此语法自动可用于所有方言（不仅是标准方言）。

还有一种语法可以指定自定义标签：{prefix}-{name}，它遵循 W3C 自定义元素规范（W3C Web Components 规范的一部分）。例如，这可以用于 th:block（或 th-block）元素，这会在后面的部分中解释。

重要提示：此语法是对命名空间 th:* 的补充，它不会取代它。目前没有计划在未来弃用命名空间语法。

# 6 迭代 到目前为止，我们已经创建了一个主页、一个用户个人资料页面以及一个让用户订阅新闻通讯的页面……但产品呢？为此，我们需要一种方法来迭代集合中的项目，以构建产品页面。

# 6.1 迭代基础 为了在 /WEB-INF/templates/product/list.html 页面中显示产品，我们使用一个表格。每个产品会显示在一行（一个 元素）中，因此对于模板，我们需要创建一个模板行——一个展示如何显示每个产品的示例——然后指示 Thymeleaf 重复它，每个产品一次。

标准方言为我们提供了一个专门用于此目的的属性：th:each。

# 使用 th:each 对于产品列表页面，我们需要一个控制器方法，该方法从服务层检索产品列表并将其添加到模板上下文中：

public void process(

final IWebExchange webExchange,

final ITemplateEngine templateEngine,

final Writer writer)

throws Exception {

final ProductService productService = new ProductService();

final List allProducts = productService.findAll();

final WebContext ctx = new WebContext(webExchange, webExchange.getLocale());

ctx.setVariable("prods", allProducts);

templateEngine.process("product/list", ctx, writer);

}

然后，我们在模板中使用 th:each 来迭代产品列表：

href="../../../css/gtvg.css" th:href="@{/css/gtvg.css}" />

Product list

Return to home

你上面看到的 prod : ${prods} 属性值的意思是“对于 ${prods} 的结果中的每个元素，重复此模板片段，并使用当前元素作为名为 prod 的变量”。让我们为每个我们看到的元素命名：

我们将 ${prods} 称为迭代表达式或迭代对象。 我们将 prod 称为迭代变量。 请注意，prod 迭代变量的范围是 元素，这意味着它可用于内部标签，如 。

# 可迭代的值 java.util.List 类并不是唯一可以用于 Thymeleaf 中迭代的值。th:each 属性认为以下对象是可迭代的：

任何实现 java.util.Iterable 的对象 任何实现 java.util.Enumeration 的对象 任何实现 java.util.Iterator 的对象，其值将按迭代器返回的顺序使用，而无需将所有值缓存在内存中 任何实现 java.util.Map 的对象。在迭代映射时，迭代变量将是 java.util.Map.Entry 类 任何实现 java.util.stream.Stream 的对象 任何数组 任何其他对象将被视为包含对象本身的单值列表 # 6.2 保持迭代状态 当使用 th:each 时，Thymeleaf 提供了一种有用的机制来跟踪迭代的状态：状态变量。

状态变量在 th:each 属性中定义，并包含以下数据：

当前迭代索引，从 0 开始。这是 index 属性。 当前迭代索引，从 1 开始。这是 count 属性。 迭代变量中的元素总数。这是 size 属性。 每次迭代的迭代变量。这是 current 属性。 当前迭代是偶数还是奇数。这是 even/odd 布尔属性。 当前迭代是否是第一次迭代。这是 first 布尔属性。 当前迭代是否是最后一次迭代。这是 last 布尔属性。 让我们看看如何在前面的示例中使用它：

状态变量（在本例中为 iterStat）通过在迭代变量本身后写入其名称来在 th:each 属性中定义，两者之间用逗号分隔。与迭代变量一样，状态变量的范围也是由包含 th:each 属性的标签定义的代码片段。

让我们看看处理模板的结果：

Product list

Return to home

请注意，我们的迭代状态变量工作得非常完美，仅为奇数行设置了 odd CSS 类。

如果你没有显式设置状态变量，Thymeleaf 将始终通过将 Stat 后缀添加到迭代变量的名称来为你创建一个：

# 6.3 通过延迟检索数据优化 有时我们可能希望优化数据集合（例如从数据库中检索）的检索，以便仅在真正使用这些集合时才检索它们。

实际上，这可以应用于任何数据，但考虑到内存中集合可能的大小，检索用于迭代的集合是这种场景中最常见的情况。

为了支持这一点，Thymeleaf 提供了一种延迟加载上下文变量的机制。实现 ILazyContextVariable 接口的上下文变量——最可能通过扩展其默认实现 LazyContextVariable——将在执行时解析。例如：

context.setVariable(

"users",

new LazyContextVariable>() {

@Override

protected List loadValue() {

return databaseRepository.findAllUsers();

}

});

这个变量可以在不知道其延迟性的情况下使用，例如在以下代码中：

• user name

但同时，如果 condition 在以下代码中评估为 false，则该变量永远不会初始化（其 loadValue() 方法永远不会被调用）：

• user name

# 7 条件评估 # 7.1 简单条件判断：if 和 unless 有时你需要模板中的某段内容仅在满足特定条件时才显示。

例如，假设我们希望在产品表中显示一列，展示每个产品的评论数量，并且如果有评论，则提供一个链接到该产品的评论详情页面。

为了实现这一点，我们可以使用 th:if 属性：

这里有很多内容要看，所以我们重点关注重要的一行：

th:href="@{/product/comments(prodId=${prod.id})}"

th:if="${not #lists.isEmpty(prod.comments)}">view

这将创建一个指向评论页面的链接（URL 为 /product/comments），并将 prodId 参数设置为产品的 id，但仅当产品有评论时才会显示。

让我们看看生成的标记：

完美！这正是我们想要的。

需要注意的是，th:if 属性不仅会评估布尔条件。它的功能还稍微超出这个范围，它将按照以下规则评估指定的表达式为 true：

如果值不为空：

如果值是布尔值且为 true。 如果值是数字且非零。 如果值是字符且非零。 如果值是字符串且不是 false、off 或 no。 如果值不是布尔值、数字、字符或字符串。 （如果值为空，th:if 将评估为 false）。 此外，th:if 还有一个反向属性 th:unless，我们可以在前面的例子中使用它，而不是在 OGNL 表达式中使用 not：

th:href="@{/comments(prodId=${prod.id})}"

th:unless="${#lists.isEmpty(prod.comments)}">view

# 7.2 Switch 语句 还有一种方式可以使用 th:switch / th:case 属性集来显示条件内容，类似于 Java 中的 switch 结构：

请注意，一旦一个 th:case 属性被评估为 true，同一 switch 上下文中的其他 th:case 属性将被评估为 false。

默认选项指定为 th:case="*"：

# 8 模板布局 # 8.1 包含模板片段 # 定义和引用片段 在我们的模板中，我们经常希望包含其他模板的部分，如页脚、页眉、菜单等。为了实现这一点，Thymeleaf 需要定义这些部分，即“片段”，可以使用 th:fragment 属性来定义。

假设我们想为所有的杂货页面添加一个标准的版权页脚，我们可以创建一个 /WEB-INF/templates/footer.html 文件，包含以下代码：

上面的代码定义了一个名为 copy 的片段，我们可以很容易地使用 th:insert 或 th:replace 属性将其包含在我们的主页中：

...

注意，th:insert 需要一个片段表达式（~{...}），即一个结果为片段的表达式。

# 片段指定语法 片段表达式的语法非常简单，有三种不同的格式：

"~{templatename::selector}"：包含在指定模板上应用标记选择器所得到的片段。注意，selector 可以是一个片段名，因此你可以指定像 ~{footer :: copy} 这样的简单内容。

"~{templatename}"：包含指定名称的完整模板。

"~{::selector}" 或 "~{this::selector}"：从同一模板中插入一个片段，匹配 selector。如果在当前模板中找不到，将向最初处理的模板（根模板）遍历模板调用堆栈，直到在某个级别匹配到 selector。

在上述示例中，templatename 和 selector 都可以是完全功能的表达式（甚至可以是条件表达式），例如：

片段可以包含任何 th:* 属性。这些属性将在片段包含到目标模板（带有 th:insert/th:replace 属性的模板）时进行评估，并且它们能够引用目标模板中定义的任何上下文变量。

# 不使用 th:fragment 引用片段 由于标记选择器的强大功能，我们可以包含不使用任何 th:fragment 属性的片段。它甚至可以来自一个完全不了解 Thymeleaf 的应用程序的标记代码：

...

...

我们可以简单地通过 id 属性引用上面的片段，类似于 CSS 选择器：

...

# th:insert 和 th:replace 的区别 th:insert 和 th:replace 的区别是什么？

th:insert 将指定的片段插入为其宿主标签的内容。 th:replace 实际上是用指定的片段替换其宿主标签。 例如，以下 HTML 片段：

在宿主