Spring Boot 什么时候需要 Thymeleaf 表达式分隔符？

Question

我正在使用带有 Thymeleaf 的 Spring Boot 2.3.3.RELEASE。从 Thymeleaf 文档中，我不清楚何时必须在 Thymeleaf 表达式中使用 ${} 分隔符。

例如，我的模板中有这个，它正在工作：

<div th:title="${doTest() ? 'foo' : 'bar'}" />

但后来我重新阅读了文档，发现我可以使用这个：

<div th:title="${doTest()} ? 'foo' : 'bar'" />

但是? … : … 三元运算符是一个运算符，所以整个事情都是一个表达式。那么为什么我不需要${} 围绕整个属性值呢？

我也可以这样做吗？

<div th:title="doTest() ? 'foo' : 'bar'" />

这个怎么样？

<div th:title="'foo'" />

为什么是一个而不是另一个？

这个呢？我可以只使用一个裸露的true吗？

<div th:if="true">…</div>

或者我需要表达式分隔符吗？

<div th:if="${true}">…</div>

这是另一个例子：我在文档中看到了这个：

<li th:text="${item.description}" …

但是我可以只使用th:text="item.description" 吗？牙套对我有什么作用？

我也看到了：

th:each="item : ${items}"

我可以改用th:each="item : items" 吗？为什么没有 ${items} 中的大括号，Thymeleaf 不知道评估 items？

当我需要${} 时，肯定有一些简单的规则，但这并不是立即显而易见的。

Answer 1

使用不带${} 的表达式将被视为值（字符串、布尔值...）、操作和条件的混合，因此thymeleaf 将尝试按原样执行表达式。这是Thymeleaf 标准表达式引擎

例如：

th:text="item.description" ：将显示item.description，如果您执行th:text="'item.description'" 则相同，因为thymeleaf 将item.description 视为文本docs。

现在将${} 与表达式一起使用，将被视为变量表达式，这意味着每个文字标记（不带''的文本）都是将在预定义的上下文中执行的变量。这是 OGNL（对象图导航语言）

在我们的例子中：

th:text="${item.description}"：将在上下文中显示项目对象的描述。在春季，您可以使用Model（或ModelAndView）在上下文中注册您的对象：
model.addAttribute("item", new Item()); 如果在上下文中找不到item，这将引发异常。

所以th:text="${'item.description'}" 和th:text="item.description" 相同，但它们的评估方式不同。

我认为现在很清楚，如果您想从模板中访问对象（模型、服务、存储库...），您应该使用 ${}。

Answer 2

• 例如，我的模板中有这个，它正在工作：- 是的，因为这是由 OGNL(Object-Graph Navigation Language) 执行的

<div th:title="{$doTest() ? 'foo' : 'bar'}" />

• 但后来我重新阅读了文档，发现我可以使用这个：- 是的，因为这是由 Thymeleaf Standard Expression engine 执行的。

<div th:title="{$doTest()} ? 'foo' : 'bar'" />

• 但是? : 是一个运算符，因此整个事情都是一个表达式。那么为什么我不需要整个属性值周围的${} 呢？ - 因为 thymeleaf 本身就有 Elvis Operator (?:)。所以Thymeleaf Standard Expression engine 能够执行它。

• 这个呢？我可以只使用一个真实的吗？

  在 Thymeleaf 中，任何值都可以计算为布尔值。我们有一些价值观 解释为false:

  • 列表项

  • 空

  • 布尔值 false

  • 数字0

  • 字符 \0

  • 字符串“false”、“off”和“no”

任何其他值都被评估为true。

• 这里有一些有用的链接：-

https://www.baeldung.com/spring-thymeleaf-conditionals

https://www.baeldung.com/thymeleaf-boolean

https://www.thymeleaf.org/doc/tutorials/2.1/usingthymeleaf.html#variables

http://commons.apache.org/ognl/

编辑：-

<div th:title="{$doTest() ? 'foo' : 'bar'}" />

<div th:title="{$doTest()} ? 'foo' : 'bar'" />

在您的情况下，您可以同时使用上述两种语法。两者的执行方式不同，但最终结果相同。第一个由 OGNL 执行，第二个由 Thymeleaf 引擎 执行。

您的疑问是为什么第二个有效？为什么我们不需要将?: 运算符放在${} 中？

上述问题的答案是Thymeleaf 引擎 本身就理解?: 运算符。它被称为猫王操作员。它类似于我们在大多数编程语言中使用的三元运算符，但略有不同。您可以在我分享的链接中阅读更多相关信息。

因此，即使我们不将?: 放入${} 中，Thymeleaf Engine 也会成功执行。

Answer 3

如果我们需要访问变量，我们使用 ${}。变量，如您的示例 item.description，其中 item 是对象/引用，而 description 是对象 item 内的字符串。

假设description 的值是“This is thymeleaf”。

为了在 html 上显示描述中的文字，我们通过以下方式实现：

<p th:text="${item.description}"></p>

输出：

这是百里香

但不使用 ${} 表达式，将在 html 上生成给定的字符串“item.description”本身，即无法解析引用。

<p th:text="item.description"></p>

输出：

项目描述

我想解释另一个可能存在异常的示例，尤其是在使用 th:if 和 th:each 时。

下面的两个表达式是相同的，并且会产生相同的输出：

<p th:if="${item.description} != null"></p>
<p th:if="${item.description != null}"></p>

上面的表达式说如果item里面的description不为null就显示段落。

Thymeleaf 希望我们使用 ${}，这样如果出现这样的表达式，它就可以将大括号内的单词与其上下文中的变量进行比较，如果找到匹配项，则返回变量值。

注意：Thymeleaf 维护一个上下文变量，可通过#ctx 访问 其中包含输入到模板的所有变量，形式为 键值对。

如果变量没有用 ${} 括起来，那么它会将字符串视为纯文本并按原样使用它们。