5分钟了解Thymeleaf的标准方言(Standard dialects)

这篇指南将介绍Thymeleaf模板技术的标准方言(Standard dialects)和Spring标准方言(SpringStandard dialects)的一些重要概念。不能替代更加详尽的教程，不过可以给你足够的技术体验。

标准方言(Standard dialects)

Thymeleaf的可扩展性很强，它支持自定义你自己的模板属性集(或事件标签)、表达式、语法及应用逻辑，它更像一个模板引擎框架。

然而，秉着“开箱即用”的原则，Thymeleaf提供了满足大多数情况下的默认实现-标准方言(Standard and SpringStandard dialects)。你可以在模板中识别出这些被使用的标准方言，因为他们都以th属性开头，如

<span th:text="...">

值得注意的是，Standard和SpringStandard方言的用法几乎相同，但是SpringStandard包括了Spring MVC集成的具体特征(比如用Spring Expression Language来替代OGNL)。

标准表达式语法(Standard Expression syntax)

大部分Thymeleaf属性允许它们的值被设置成或包含到表达式中，我们称之为标准表达式，
它们分为四类：
1.变量表达式
2.选择或星号表达式
3.文字国际化表达式
4.URL表达式

变量表达式

变量表达式即OGNL表达式或Spring EL表达式(在Spring术语中也叫model attributes)。如下所示：

${session.user.name}

它们将以HTML标签的一个属性来表示：

<span th:text="${book.author.name}">
<li th:each="book : ${books}">

选择(星号)表达式

选择表达式很像变量表达式，不过它们用一个预先选择的对象来代替上下文变量容器(map)来执行，如下：

*{customer.name}

被指定的object由th:object属性定义：

<div th:object="${book}">
...
<span th:text="*{title}">...</span>
...
</div>

文字国际化表达式

文字国际化表达式允许我们从一个外部文件获取区域文字信息(.properties)，用Key索引Value，还可以提供一组参数(可选).

#{main.title}
#{message.entrycreated(${entryId})}

可以在模板文件中找到这样的表达式代码：

<table>
...
<th th:text="#{header.address.city}">...</th>
<th th:text="#{header.address.country}">...</th>
...
</table>

URL表达式

URL表达式指的是把一个有用的上下文或回话信息添加到URL，这个过程经常被叫做URL重写。

@{/order/list}

URLs还可以设置参数：

@{/order/details(id=${orderId})}

相对路径：

@{../documents/report}

让我们看这些表达式：

<form th:action="@{/createOrder}">

<a href="main.html" th:href="@{/main}">

字面量和操作

Thymeleaf有一组可用的字面量和操作。

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)

表达式预处理

最后要讲到的是表达式预处理，它被定义在_之间：

#{selection.__${sel.code}__}

我们看到的变量表达式${sel.code}将先被执行，加入结果是"ALL"，那么_之间的值"ALL"将被看做表达式的一部分被执行，在这里会变成selection.ALL。

一些基本属性

让我们看一组最基本的标准方言属性，以th:text开头，替换标签中的文字内容(这里再次强调THymeleaf的原型支持能力)。

<p th:text="#{msg.welcome}">Welcome everyone!</p>

th:each将循环array或list中的元素并重复打印一组标签。

<li th:each="book : ${books}" th:text="${book.title}">En las Orillas del Sar</li>

最后，Thymeleaf有很多th属性来定义XHTML或者HTML5属性，这些属性只是执行表达式并把值设置成HTML的属性值：

<form th:action="@{/createOrder}">
<input type="button" th:value="#{form.submit}" />
<a th:href="@{/admin/users}">

想了解更多？

请参考更详尽文档。