Thymeleaf入门

最新推荐文章于 2023-08-03 08:10:11 发布

Akiler

最新推荐文章于 2023-08-03 08:10:11 发布

阅读量397

点赞数 1

分类专栏： spring boot 文章标签： java 开发语言

本文链接：https://blog.csdn.net/Akiler/article/details/125390188

版权

spring boot 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

理解Thymeleaf

Java模版引擎：Thymeleaf是一个用于Web和独立环境的现代服务器端Java模板引擎。能够处理HTML、XML、JavaScript、CSS甚至纯文本。

自然模板：Thymeleaf的主要目标是为您的开发工作流程带来优雅的自然模板——HTML，它可以在浏览器中正确显示，也可以作为静态原型工作（原型即界面），改善了设计与开发的沟通，从而在开发团队中实现更强的协作。

<table>  
  <thead>  
    <tr>  
      <th th:text="#{msgs.headers.name}">Name</th>  
      <th th:text="#{msgs.headers.price}">Price</th>  
    </tr>  
  </thead>  
  <tbody>  
    <tr th:each="prod: ${allProducts}">  
      <td th:text="${prod.name}">Oranges</td>  
      <td th:text="${#numbers.formatDecimal(prod.price, 1, 2)}">0.99</td>  
    </tr>  
  </tbody>  
</table>

语法优雅易懂：
遵从web标准，支持HTML5

Thymeleaf 使用

秉着“开箱即用”的原则，Thymeleaf提供了满足大多数情况下的默认实现-标准方言（后面会介绍自定义方言）：

引入标签库（命名空间），常用的一种方式：

<!--需要引入命名空间-->
<html xmlns:th="http://www.thymeleaf.org">  
<span th:text="">....</span>

HTML5标准，自定义属性: 这样可以省去命名空间

<span data-th-text="">.....</span>  
<table>  
    <tr data-th-each="user : ${users}">  
        <td data-th-text="${user.login}">...</td>  
        <td data-th-text="${user.name}">...</td>  
    </tr>  
</table>

Thymeleaf基本语法

标准表达式

变量表达式

语法：${...}

用法：

<p th:text="${book.author}"></p>

消息表达式

语法：#{...}

用法：

<p th:text="#{home.welcome}">Welcome to our grocery store!</p>

相当于消息的一个key，也称文本外部化，一般用于国际化等外部配置文件，其中properties文件内容为

home.welcome=welcome to thymeleaf

目前消息文件中的内容是固定的，如果我们需要向消息中动态插入一个参数以便实现动态消息，可以#{messageKey(param=value)}，多个参数用,分割-#{messageKey(param1=value1， param2=value2)}，messageKey本身也可以是一个变量表达式：

home.welcome=welcome to {0}

<p th:utext="#{home.welcome(${session.user.name})}">   
       Welcome to our grocery store, Sebastian Pepper!   
</p>  
  
<p th:utext="#{${welcomeMsgKey}(${session.user.name})}">  
  Welcome to our grocery store, Sebastian Pepper!  
</p>

消息源

大多数情况下, 消息源是.properties文件，同时可以自定义其他消息源，比如数据库。消息源通过org.thymeleaf.messageresolver.IMessageResolver获取，如果在初始化模板引擎时没有自定义的IMessageResolver被提供，那么一个默认的实现org.thymeleaf.messageresolver.StandardMessageResolver会被自动提供。

StandardMessageResolver查找和模板文件位于同级目录，且具有和模板文件相同名字的.properties文件。

模板/templates/home.html在渲染时，会根据local设置，使用下面的消息源文件

/templates/home_zh_CN.properties --->中文
/templates/home_en.properties --->英文
/templates/home.properties 如--->特定的lcoal不可用时使用

在spring boot中，默认去寻找resources下面名为messages的properties文件，可以通过spring.messages.basename进行修改

选择表达式

语法：*{...}

示例：

<div th:object="${session.book}">  
<p>Name: <span th:text="*{title}">thymeleaf实战</span>.</p>  
<p>Surname: <span th:text="*{author}">Peppa</span>.</p>  
<p>Nationality: <span th:text="*{price}">300</span>.</p>  
</div>

与变量表达式的区别：它们是在当前选择的对象而不是整个上下文变量映射上执行（性能高）

链接表达式

语法：@{...}

示例

绝对url:

<a th:href="@{http://www.thymeleaf.org}" th:text="">...</>

相对url，可以是:

相对url: user/login.html
上下文相对: /itemdetails?id=3 (自动添加服务器中的应用上下文名称)
服务器相对: ~/billing/processInvoice (允许在同一服务器的另一个上下文（=应用程序）中调用URL）.
协议相对: //code.jquery.com/jquery-2.0.3.min.js

eg：

在链接中使用参数（变量）
<a href="details.html" th:href="@{/order/details(orderId=${o.id})}">view</a>
多个参数：
<a href="details.html" th:href="@{/order/details(orderId=${o.id},orderType=${o.type})}">view</a>
RESTful风格：
<a href="details.html" th:href="@{/order/{orderId}/details(orderId=${orderId})}">view</a>

片段表达式

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

语法：~{...}

示例：

<div th:align="center" th:fragment="footer">

...

</div>

定义片段

<div th:insert="~{commons :: footer}">...</div>

使用th:insert or th:replace插入片段，它们可以在任何地方使用，就像任何其他变量一样：

<div th:with="frag=~{footer :: #footer/text()}">  
<p th:insert="${frag}">  
</div>

Thymeleaf基本语法

字面量

文本字面量: 'one text', 'Another one!',…

<p th:text="'<h1>我是一个香蕉，蕉蕉蕉蕉蕉蕉</h1>'"</p>  

<p th:utext="'<h1>我是一个香蕉，蕉蕉蕉蕉蕉蕉</h1>'"</p>

区别：th：text对html标签转义，th：utext不转义，解析为html内容

数字字面量: 0, 34, 3.0, 12.3,…
Boolean 字面量: true, false
Null 值字面量: null
文字标记: one, sometext, main,…（不需要单引号''，这些令牌允许在标准表达式中进行一点简化。它们的工作与文本文字（'...'）完全相同，但它们只允许使用字母（A-Z和a-z），数字（0-9），括号（[和]），点（.），连字符（-）和下划线（_）。所以没有空白，没有逗号等）
文本操作:
- 字符串连接: +
- 文字替换: |The name is ${name}|
算术运算符:
- 二元运算符: +, -, *, /, %
- 减号(一元运算): -
逻辑运算符:
- 二元运算符: and, or
- 逻辑非(一元运算符): !, not
比较运算符:
- 比较运算符: >, <, >=, <= (gt, lt, ge, le)
- 相等比较: ==, != (eq, ne)
条件运算符:
- If-then: (if) ? (then)
- If-then-else: (if) ? (then) : (else)
- Default: (value) ?: (defaultvalue)
Special tokens:
- No-Operation（无操作）: _ 如果条件不满足，保留在原型中定义的值（文本）

<p th:utext="${user.username}?:_">我是原型的值</p>

设置属性值

Java模版引擎：Thymeleaf是一个用于Web和独立环境的现代服务器端Java模板引擎。能够处理

设置任意属性值-->th:attr

<form action="subscribe.html" th:attr="action=@{/subscribe}">  
  <fieldset>  
    <input type="text" name="email" />  
    <input type="submit" value="Subscribe!" th:attr="value=#{subscribe.submit}"/>  
  </fieldset>  
</form>

设置值到指定的属性---->HTML5标签的常用属性。如：

<input type="submit" value="Subscribe!" th:value="#{subscribe.submit}"/>  
<form action="subscribe.html" th:action="@{/subscribe}">  
<li><a href="product/list.html" th:href="@{/product/list}">Product List</a></li>

固定值布尔属性---->属性就代表值

<input type="checkbox" name="active" th:checked="${user.active}" />

迭代器

基本的迭代---->th:each

<li th:each="book:${books}" th:text="${book.title}"></li>

　　 ${books}为迭代变量（作用域中的Iterable，Enumeration，Iterator，Map，Entry，Array及字符串等，相当于标准标签库中<c:forEach>里的items属性）；

　　book为当前迭代的元素，相当于var属性

　　状态变量：跟踪迭代器的状态（相当于标准标签库的varStatus标签）

<table>  
  <tr>  
    <th>NAME</th>  
    <th>PRICE</th>  
    <th>IN STOCK</th>  
  </tr>  
  <tr th:each="prod,iterStat : ${prods}" th:class="${iterStat.odd}? 'odd'">  
    <td th:text="${prod.name}">Onions</td>  
    <td th:text="${prod.price}">2.41</td>  
    <td th:text="${prod.inStock}? #{true} : #{false}">yes</td>  
  </tr>  
</table>

index：当前迭代索引，从0开始。

count：当前迭代索引，从1开始。

size：迭代变量中元素的总数。

current：每个迭代的ITER变量。

even/odd:当前迭代是偶数还是奇数。

first:当前迭代是否为第一个元素。

last：当前迭代是否为最后一个元素。

条件语句

th:if

<a href="comments.html"  
th:href="@{/product/comments(prodId=${prod.id})}"   
th:if="${not #lists.isEmpty(prod.comments)}">view</a>

th:unless---->条件不成立

<a href="comments.html"  
th:href="@{/comments(prodId=${prod.id})}"   
th:unless="${#lists.isEmpty(prod.comments)}">view</a>

th:switch/th:case

<div th:switch="${user.role}">  
  <p th:case="'admin'">User is an administrator</p>  
  <p th:case="#{roles.manager}">User is a manager</p>  
  <p th:case="*">User is some other thing</p>  
</div>

模板布局

在我们的模板中，我们通常希望包括来自其他模板的部件，如页脚、页眉、菜单等部件（公共部分）；或是固定的模板格式渲染成不同的内容，如邮件模板，商品详情页模板…
为了做到这一点，thymeleaf需要我们定义这些部分，“片段”，以便包含，这可以使用th:fragment属性完成。
假设我们想在所有杂货店页面中添加一个标准的版权页脚，那么我们创建一个/templates/footer.html文件，其中包含以下代码：

<!DOCTYPE html>  
<html xmlns:th="http://www.thymeleaf.org">  
  <body>  
    <div th:fragment="copy">  
      &copy; 2011 The Good Thymes Virtual Grocery  
    </div>  
  </body>  
</html>

使用th:insert或者th:replace插入片段，th:include只插入片段内容（不推荐使用）

<body>  
  ...  
  <div th:insert="~{footer :: copy}"></div>  
</body>

其中footer为模板名称，copy为片段名称，也可以不使用th:fragment,使用格式如下

<div id="copy-section">  
  &copy; 2011 The Good Thymes Virtual Grocery  
</div>  
...  
<body>  
  ...  
  <div th:insert="~{footer :: #copy-section}"></div>  
</body>

注释

标准html/xml注释

thymeleaf解析器级注释

<!--/* 
  <div th:text="${...}"> 
    ... 
  </div> 
*/-->  
原型注释块[静态时注释，模板执行时显示
<!--/*/  
  <div th:text="${...}">  
    ...  
  </div>  
/*/-->

内联

直接将表达式写在文本中而非标签中，js，css中使用常见

<script th:inline="javascript">  
    ...  
var username = [[${session.user.name}]];  
    ...  
</script>

格式：[[...]]或者[(...)]分别对应th:text和th:utext

禁用内联---->th:inline="none"

块

标准方言中包含的thymeleaf的唯一元素处理器（不是属性）是th:block。
th:block是一个属性容器，允许模板开发人员指定他们想要的属性。thymeleaf将执行这些属性，然后简单地使块（而不是其内容）消失。
因此，它可能很有用，例如，当创建迭代表时，每个元素需要一个以上的<tr>,或者需要条件判断时

<table>  
  <th:block th:each="user : ${users}">  
    <tr>  
        <td th:text="${user.login}">...</td>  
        <td th:text="${user.name}">...</td>  
    </tr>  
    <tr>  
        <td colspan="2" th:text="${user.address}">...</td>  
    </tr>  
  </th:block>  
</table>

表达式基本对象（隐式对象，存在于上下文中）

#ctx：上下文对象

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.context.IContext 
 * ====================================================================== 
 */  
${#ctx.locale}  
${#ctx.variableNames}  
  
/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.context.IWebContext 
 * ====================================================================== 
 */  
  
${#ctx.request}  
${#ctx.response}  
${#ctx.session}  
${#ctx.servletContext}

#locale：直接访问与java.util.Locale关联的当前请求

${#locale}

param:获取请求相关的属性，如请求参数，request.getParmeter("")等

/* 
 * ============================================================================ 
 * See javadoc API for class org.thymeleaf.context.WebRequestParamsVariablesMap 
 * ============================================================================ 
 */  
  
${param.foo}  //request.getParameterValues("foo")              
${param.size()}  
${param.isEmpty()}  
${param.containsKey('foo')}  
...

session: for retrieving session attributes.

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.context.WebSessionVariablesMap 
 * ====================================================================== 
 */  
  
${session.foo}  // session.getAtttribute('foo')  
${session.size()}  
${session.isEmpty()}  
${session.containsKey('foo')}  
...

application : for retrieving application/servlet context attributes.

/* 
 * ============================================================================= 
 * See javadoc API for class org.thymeleaf.context.WebServletContextVariablesMap 
 * ============================================================================= 
 */  
  
${application.foo}      //servletContext.getAtttribute('foo')  
${application.size()}  
${application.isEmpty()}  
${application.containsKey('foo')}  
${myRequestAttribute}
...

Web 上下文对象

#request : 当前请求javax.servlet.http.HttpServletRequest .

${#request.getAttribute('foo')}  
${#request.getParameter('foo')}  
${#request.getContextPath()}  
${#request.getRequestName()}  
...

#session : javax.servlet.http.HttpSession

${#session.getAttribute('foo')}  
${#session.id}  
${#session.lastAccessedTime}  
...

#servletContext : javax.servlet.ServletContext

${#servletContext.getAttribute('foo')}  
${#servletContext.contextPath}  
...

实用对象

这些使用表达式对象在package org.thymeleaf.expression包下都有对应的类，如果不知道怎么使用直接看Javadoc就好，推荐使用的时候按需查询。

Messages

#messages : 用于在变量表达式中获得外部消息的实用方法，与使用#{…}语法获得的方式相同.

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Messages 
 * ====================================================================== 
 */  
  
${#messages.msg('msgKey')}  
${#messages.msg('msgKey', param1)}  
${#messages.msg('msgKey', param1, param2)}  
${#messages.msg('msgKey', param1, param2, param3)}  
${#messages.msgWithParams('msgKey', new Object[] {param1, param2, param3, param4})}  
${#messages.arrayMsg(messageKeyArray)}  
${#messages.listMsg(messageKeyList)}  
${#messages.setMsg(messageKeySet)}  
  
${#messages.msgOrNull('msgKey')}  
${#messages.msgOrNull('msgKey', param1)}  
${#messages.msgOrNull('msgKey', param1, param2)}  
${#messages.msgOrNull('msgKey', param1, param2, param3)}  
${#messages.msgOrNullWithParams('msgKey', new Object[] {param1, param2, param3, param4})}  
${#messages.arrayMsgOrNull(messageKeyArray)}  
${#messages.listMsgOrNull(messageKeyList)}  
${#messages.setMsgOrNull(messageKeySet)}

URIs/URLs

#uris : 用于在Thymeleaf标准表达式中执行URI / URL操作（特别是转义/消除转义）的实用对象.

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Uris 
 * ====================================================================== 
 */  
  
/* 
 * Escape/Unescape as a URI/URL path 
 */  
${#uris.escapePath(uri)}  
${#uris.escapePath(uri, encoding)}  
${#uris.unescapePath(uri)}  
${#uris.unescapePath(uri, encoding)}  
  
/* 
 * Escape/Unescape as a URI/URL path segment (between '/' symbols) 
 */  
${#uris.escapePathSegment(uri)}  
${#uris.escapePathSegment(uri, encoding)}  
${#uris.unescapePathSegment(uri)}  
${#uris.unescapePathSegment(uri, encoding)}  
  
/* 
 * Escape/Unescape as a Fragment Identifier (#frag) 
 */  
${#uris.escapeFragmentId(uri)}  
${#uris.escapeFragmentId(uri, encoding)}  
${#uris.unescapeFragmentId(uri)}  
${#uris.unescapeFragmentId(uri, encoding)}  
  
/* 
 * Escape/Unescape as a Query Parameter (?var=value) 
 */  
${#uris.escapeQueryParam(uri)}  
${#uris.escapeQueryParam(uri, encoding)}  
${#uris.unescapeQueryParam(uri)}  
${#uris.unescapeQueryParam(uri, encoding)}

Conversions

#conversions : 允许在模板的任意位置执行转换服务的实用程序对象:

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Conversions 
 * ====================================================================== 
 */  
  
/* 
 * Execute the desired conversion of the 'object' value into the 
 * specified class. 
 */  
${#conversions.convert(object, 'java.util.TimeZone')}  
${#conversions.convert(object, targetClass)}

Dates

#dates : 为 java.util.Date对象提供工具方法,比如：格式化,提取年月日等:

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Dates 
 * ====================================================================== 
 */  
  
${#dates.format(date)}  
${#dates.arrayFormat(datesArray)}  
${#dates.listFormat(datesList)}  
${#dates.setFormat(datesSet)}  
  
${#dates.formatISO(date)}  
${#dates.arrayFormatISO(datesArray)}  
${#dates.listFormatISO(datesList)}  
${#dates.setFormatISO(datesSet)}  
  
  
${#dates.format(date, 'dd/MMM/yyyy HH:mm')}  
${#dates.arrayFormat(datesArray, 'dd/MMM/yyyy HH:mm')}  
${#dates.listFormat(datesList, 'dd/MMM/yyyy HH:mm')}  
${#dates.setFormat(datesSet, 'dd/MMM/yyyy HH:mm')}  
  
${#dates.day(date)}                    // also arrayDay(...), listDay(...), etc.  
${#dates.month(date)}                  // also arrayMonth(...), listMonth(...), etc.  
${#dates.monthName(date)}              // also arrayMonthName(...), listMonthName(...), etc.  
${#dates.monthNameShort(date)}         // also arrayMonthNameShort(...), listMonthNameShort(...), etc.  
${#dates.year(date)}                   // also arrayYear(...), listYear(...), etc.  
${#dates.dayOfWeek(date)}              // also arrayDayOfWeek(...), listDayOfWeek(...), etc.  
${#dates.dayOfWeekName(date)}          // also arrayDayOfWeekName(...), listDayOfWeekName(...), etc.  
${#dates.dayOfWeekNameShort(date)}     // also arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...), etc.  
${#dates.hour(date)}                   // also arrayHour(...), listHour(...), etc.  
${#dates.minute(date)}                 // also arrayMinute(...), listMinute(...), etc.  
${#dates.second(date)}                 // also arraySecond(...), listSecond(...), etc.  
${#dates.millisecond(date)}            // also arrayMillisecond(...), listMillisecond(...), etc.  
  
/* 
 * Create date (java.util.Date) objects from its components 
 */  
${#dates.create(year,month,day)}  
${#dates.create(year,month,day,hour,minute)}  
${#dates.create(year,month,day,hour,minute,second)}  
${#dates.create(year,month,day,hour,minute,second,millisecond)}  
  
/* 
 * Create a date (java.util.Date) object for the current date and time 
 */  
${#dates.createNow()}  
  
${#dates.createNowForTimeZone()}  
  
/* 
 * Create a date (java.util.Date) object for the current date (time set to 00:00) 
 */  
${#dates.createToday()}  
  
${#dates.createTodayForTimeZone()}

Calendars

#calendars : 类似于#dates , 但是只针对java.util.Calendar对象:

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Calendars 
 * ====================================================================== 
 */  
  
/* 
 * Format calendar with the standard locale format 
 * Also works with arrays, lists or sets 
 */  
${#calendars.format(cal)}  
${#calendars.arrayFormat(calArray)}  
${#calendars.listFormat(calList)}  
${#calendars.setFormat(calSet)}  
  
/* 
 * Format calendar with the ISO8601 format 
 * Also works with arrays, lists or sets 
 */  
${#calendars.formatISO(cal)}  
${#calendars.arrayFormatISO(calArray)}  
${#calendars.listFormatISO(calList)}  
${#calendars.setFormatISO(calSet)}  
  
/* 
 * Format calendar with the specified pattern 
 * Also works with arrays, lists or sets 
 */  
${#calendars.format(cal, 'dd/MMM/yyyy HH:mm')}  
${#calendars.arrayFormat(calArray, 'dd/MMM/yyyy HH:mm')}  
${#calendars.listFormat(calList, 'dd/MMM/yyyy HH:mm')}  
${#calendars.setFormat(calSet, 'dd/MMM/yyyy HH:mm')}  
  
/* 
 * Obtain calendar properties 
 * Also works with arrays, lists or sets 
 */  
${#calendars.day(date)}                // also arrayDay(...), listDay(...), etc.  
${#calendars.month(date)}              // also arrayMonth(...), listMonth(...), etc.  
${#calendars.monthName(date)}          // also arrayMonthName(...), listMonthName(...), etc.  
${#calendars.monthNameShort(date)}     // also arrayMonthNameShort(...), listMonthNameShort(...), etc.  
${#calendars.year(date)}               // also arrayYear(...), listYear(...), etc.  
${#calendars.dayOfWeek(date)}          // also arrayDayOfWeek(...), listDayOfWeek(...), etc.  
${#calendars.dayOfWeekName(date)}      // also arrayDayOfWeekName(...), listDayOfWeekName(...), etc.  
${#calendars.dayOfWeekNameShort(date)} // also arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...), etc.  
${#calendars.hour(date)}               // also arrayHour(...), listHour(...), etc.  
${#calendars.minute(date)}             // also arrayMinute(...), listMinute(...), etc.  
${#calendars.second(date)}             // also arraySecond(...), listSecond(...), etc.  
${#calendars.millisecond(date)}        // also arrayMillisecond(...), listMillisecond(...), etc.  
  
/* 
 * Create calendar (java.util.Calendar) objects from its components 
 */  
${#calendars.create(year,month,day)}  
${#calendars.create(year,month,day,hour,minute)}  
${#calendars.create(year,month,day,hour,minute,second)}  
${#calendars.create(year,month,day,hour,minute,second,millisecond)}  
  
${#calendars.createForTimeZone(year,month,day,timeZone)}  
${#calendars.createForTimeZone(year,month,day,hour,minute,timeZone)}  
${#calendars.createForTimeZone(year,month,day,hour,minute,second,timeZone)}  
${#calendars.createForTimeZone(year,month,day,hour,minute,second,millisecond,timeZone)}  
  
/* 
 * Create a calendar (java.util.Calendar) object for the current date and time 
 */  
${#calendars.createNow()}  
  
${#calendars.createNowForTimeZone()}  
  
/* 
 * Create a calendar (java.util.Calendar) object for the current date (time set to 00:00) 
 */  
${#calendars.createToday()}  
  
${#calendars.createTodayForTimeZone()}

Numbers

#numbers : 为数值型对象提供工具方法:

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Numbers 
 * ====================================================================== 
 */  
  
/* 
 * ========================== 
 * Formatting integer numbers 
 * ========================== 
 */  
  
/*  
 * Set minimum integer digits. 
 * Also works with arrays, lists or sets 
 */  
${#numbers.formatInteger(num,3)}  
${#numbers.arrayFormatInteger(numArray,3)}  
${#numbers.listFormatInteger(numList,3)}  
${#numbers.setFormatInteger(numSet,3)}  
  
  
/*  
 * Set minimum integer digits and thousands separator:  
 * 'POINT', 'COMMA', 'WHITESPACE', 'NONE' or 'DEFAULT' (by locale). 
 * Also works with arrays, lists or sets 
 */  
${#numbers.formatInteger(num,3,'POINT')}  
${#numbers.arrayFormatInteger(numArray,3,'POINT')}  
${#numbers.listFormatInteger(numList,3,'POINT')}  
${#numbers.setFormatInteger(numSet,3,'POINT')}  
  
  
/* 
 * ========================== 
 * Formatting decimal numbers 
 * ========================== 
 */  
  
/* 
 * Set minimum integer digits and (exact) decimal digits. 
 * Also works with arrays, lists or sets 
 */  
${#numbers.formatDecimal(num,3,2)}  
${#numbers.arrayFormatDecimal(numArray,3,2)}  
${#numbers.listFormatDecimal(numList,3,2)}  
${#numbers.setFormatDecimal(numSet,3,2)}  
  
/* 
 * Set minimum integer digits and (exact) decimal digits, and also decimal separator. 
 * Also works with arrays, lists or sets 
 */  
${#numbers.formatDecimal(num,3,2,'COMMA')}  
${#numbers.arrayFormatDecimal(numArray,3,2,'COMMA')}  
${#numbers.listFormatDecimal(numList,3,2,'COMMA')}  
${#numbers.setFormatDecimal(numSet,3,2,'COMMA')}  
  
/* 
 * Set minimum integer digits and (exact) decimal digits, and also thousands and  
 * decimal separator. 
 * Also works with arrays, lists or sets 
 */  
${#numbers.formatDecimal(num,3,'POINT',2,'COMMA')}  
${#numbers.arrayFormatDecimal(numArray,3,'POINT',2,'COMMA')}  
${#numbers.listFormatDecimal(numList,3,'POINT',2,'COMMA')}  
${#numbers.setFormatDecimal(numSet,3,'POINT',2,'COMMA')}  
  
  
/*  
 * ===================== 
 * Formatting currencies 
 * ===================== 
 */  
  
${#numbers.formatCurrency(num)}  
${#numbers.arrayFormatCurrency(numArray)}  
${#numbers.listFormatCurrency(numList)}  
${#numbers.setFormatCurrency(numSet)}  
  
/*  
 * ====================== 
 * Formatting percentages 
 * ====================== 
 */  
  
${#numbers.formatPercent(num)}  
${#numbers.arrayFormatPercent(numArray)}  
${#numbers.listFormatPercent(numList)}  
${#numbers.setFormatPercent(numSet)}  
  
/*  
 * Set minimum integer digits and (exact) decimal digits. 
 */  
${#numbers.formatPercent(num, 3, 2)}  
${#numbers.arrayFormatPercent(numArray, 3, 2)}  
${#numbers.listFormatPercent(numList, 3, 2)}  
${#numbers.setFormatPercent(numSet, 3, 2)}  
  
/* 
 * =============== 
 * Utility methods 
 * =============== 
 */  
/* 
 * Create a sequence (array) of integer numbers going 
 * from x to y 
 */  
${#numbers.sequence(from,to)}  
${#numbers.sequence(from,to,step)}

Strings

#strings : 为String 对象提供工具方法。如: contains, startsWith, prepending/appending等:

Objects

#objects : 为object 对象提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Objects 
 * ====================================================================== 
 */  
  
/* 
 * Return obj if it is not null, and default otherwise 
 * Also works with arrays, lists or sets 
 */  
${#objects.nullSafe(obj,default)}  
${#objects.arrayNullSafe(objArray,default)}  
${#objects.listNullSafe(objList,default)}  
${#objects.setNullSafe(objSet,default)}

Booleans

#bools : 为boolean 对象提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Bools 
 * ====================================================================== 
 */

Arrays

#arrays : 为arrays 对象提供常用的工具方法；

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Arrays 
 * ====================================================================== 
 */  
/* 
 * Converts to array, trying to infer array component class. 
 * Note that if resulting array is empty, or if the elements 
 * of the target object are not all of the same class, 
 * this method will return Object[]. 
 */  
${#arrays.toArray(object)}  
  
/* 
 * Convert to arrays of the specified component class. 
 */  
${#arrays.toStringArray(object)}  
${#arrays.toIntegerArray(object)}  
${#arrays.toLongArray(object)}  
${#arrays.toDoubleArray(object)}  
${#arrays.toFloatArray(object)}  
${#arrays.toBooleanArray(object)}  
/* 
 * Compute length 
 */  
${#arrays.length(array)}  
  
/* 
 * Check whether array is empty 
 */  
${#arrays.isEmpty(array)}  
  
/* 
 * Check if element or elements are contained in array 
 */  
${#arrays.contains(array, element)}  
${#arrays.containsAll(array, elements)}

Lists

#lists :为lists对象提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Lists 
 * ====================================================================== 
 */  
  
/* 
 * Converts to list 
 */  
${#lists.toList(object)}  
  
/* 
 * Compute size 
 */  
${#lists.size(list)}  
  
/* 
 * Check whether list is empty 
 */  
${#lists.isEmpty(list)}  
  
/* 
 * Check if element or elements are contained in list 
 */  
${#lists.contains(list, element)}  
${#lists.containsAll(list, elements)}  
  
/* 
 * Sort a copy of the given list. The members of the list must implement 
 * comparable or you must define a comparator. 
 */  
${#lists.sort(list)}  
${#lists.sort(list, comparator)}

Sets

#sets : 为lists对象提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Sets 
 * ====================================================================== 
 */  
  
/* 
 * Converts to set 
 */  
${#sets.toSet(object)}  
  
/* 
 * Compute size 
 */  
${#sets.size(set)}  
  
/* 
 * Check whether set is empty 
 */  
${#sets.isEmpty(set)}  
  
/* 
 * Check if element or elements are contained in set 
 */  
${#sets.contains(set, element)}  
${#sets.containsAll(set, elements)}

Maps

#maps : 为lists对象提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Maps 
 * ====================================================================== 
 */  
  
/* 
 * Compute size 
 */  
${#maps.size(map)}  
  
/* 
 * Check whether map is empty 
 */  
${#maps.isEmpty(map)}  
  
/* 
 * Check if key/s or value/s are contained in maps 
 */  
${#maps.containsKey(map, key)}  
${#maps.containsAllKeys(map, keys)}  
${#maps.containsValue(map, value)}  
${#maps.containsAllValues(map, value)}

Aggregates

#aggregates : 为创造一个arrays 或者 collections聚集函数提供常用的工具方法

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Aggregates 
 * ====================================================================== 
 */  
  
/* 
 * Compute sum. Returns null if array or collection is empty 
 */  
${#aggregates.sum(array)}  
${#aggregates.sum(collection)}  
  
/* 
 * Compute average. Returns null if array or collection is empty 
 */  
${#aggregates.avg(array)}  
${#aggregates.avg(collection)}

IDs

#ids :为可能需要循环的ID属性提供常用的工具方法.

/* 
 * ====================================================================== 
 * See javadoc API for class org.thymeleaf.expression.Ids 
 * ====================================================================== 
 */  
  
/* 
 * Normally used in th:id attributes, for appending a counter to the id attribute value 
 * so that it remains unique even when involved in an iteration process. 
 */  
${#ids.seq('someId')}  
  
/* 
 * Normally used in th:for attributes in <label> tags, so that these labels can refer to Ids 
 * generated by means if the #ids.seq(...) function. 
 * 
 * Depending on whether the <label> goes before or after the element with the #ids.seq(...) 
 * function, the "next" (label goes before "seq") or the "prev" function (label goes after  
 * "seq") function should be called. 
 */  
${#ids.next('someId')}  
${#ids.prev('someId')}