码迷,mamicode.com
首页 > 其他好文 > 详细

Thymeleaf教程入门到深入1:基础介绍

时间:2018-07-11 20:07:08      阅读:146      评论:0      收藏:0      [点我收藏+]

标签:list   empty   ase   with   mode   教程   freemark   展示   3.0   

1 介绍

1.1 简介

  Thymeleaf是一个用于Web和独立Java环境的模板引擎,能够处理HTML、XML、JavaScript、CSS甚至纯文本。能轻易的与Spring MVC等Web框架进行集成作为Web应用的模板引擎。与其它模板引擎(比如FreeMaker)相比,Thymeleaf最大的特点是能够直接在浏览器中打开并正确显示模板页面,而不需要启动整个Web应用(更加方便前后端分离,比如方便类似VUE前端设计页面),抛弃JSP吧。
  Thymeleaf 3.0是一个完全彻底重构的模板引擎(官网原文:Thymeleaf 3.0 builds around a completely new template processing engine),极大的减少内存占用和提升性能和并发性,避免v2.1版因大量的输出标记的集合产生的资源占用。
  Thymeleaf 3.0放弃了大多数面向DOM的处理机制,变成了一个基于事件的模板处理器,它通过处理模板标记或文本并立即生成其输出,甚至在新事件之前响应模板解析器/缓存事件。Thymeleaf是Spring Boot官方的推荐使用模板。

3.0版的模型解析事件模型:

技术分享图片

2.1的性能和Velocity、Freemarker原先十几倍的差距,到了2015年的3.0版时已经在显著缩小,但目前性能还是和主流引擎有差距,见:

https://github.com/jreijn/spring-comparing-template-engines/issues/19

1.2 模板类型

允许您处理六种模板,有:

- HTML
- XML
- TEXT
- JAVASCRIPT
- CSS
- RAW

2 标准表达式语法


2.1 简单表达式

  • 变量表达式: ${...}
  • 选择变量表达式: *{...}
  • 消息表达式: #{...}
  • URL 表达式: @{...}
  • 代码段表达式: ~{...}

变量表达式 Variable expressions: ${...}

变量表达式在Spring中就是模型属性

例如:${user.name}
定义在属性中:<span th:text="${book.author.name}">
遍历:<li th:each="book : ${books}">

<!-- springmvc 保存了一个 model 对象: departments -->

<!-- 获取所有 departments -->
<p th:text="${departments}"></p>
<!-- 获取 departments 的第一个元素 -->
<p th:text="${departments[0]}"></p>
<!-- 获取第一个 department 对象的 name 属性 -->
<p th:text="${departments[0].name}"></p>
<!-- 也可以用 [‘name‘] 来获取第一个 department 对象的 name 属性 -->
<p th:text="${departments[0][‘name‘]}"></p>
<!-- 甚至可以调用方法! -->
<p th:text="${departments[0].getId()}"></p>
<p th:text="${departments[0][‘name‘].substring(0, 1)}"></p>

 

选择变量表达式 Selection expressions: *{...}

选择表达式就像变量表达式,它们用于先前选择的对象上执行,而不是在整个上下文变量映射中执行。
只要是没有选择的对象,选择表达式与变量表达式的语法是完全一样的。那什么是选择的对象呢?是一个:th:object对象属性绑定的对象。

例如:*{customer.name}
展示book变量的属性:

<div th:object="${book}">
<span th:text="*{title}">...</span>
</div>
<div th:object="document[2]">
<!-- 以下三种方式在这种情况下是等价的 -->
<p th:text="${#object.id}"></p>
<p th:text="*{id}"></p>
<p th:text="${document[2].id}"></p>
</div>

消息表达式 Message expressions: #{...}

消息表达式用于展示静态资源的内容,比如i18n属性配置文件

例如:#{main.title}
一个完整的例子:

<table>
...
<th th:text="#{header.address.city}">...</th>
<th th:text="#{header.address.country}">...</th>
...
</table>
<!-- 还可以结合变量表达式使用  -->
#{${config.welcomeKey}}

比如新建/WEB-INF/templates/home.properties,home.welcome的内容:home.welcome=this messages is from home.properties!
使用消息表达式:<p th: text=" #{home.welcome}" >This text will not be show! </p>

一个更深入的例子:

结合消息表达式、变量表达式、预处理表达式

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


看上去很乱是吧,实际上可以分解成3步:
1、先计算变量${sel.code},假如值是welcome
2、__的含义是需要预处理的变量值,那么就变成#{home.welcome}
3、计算最终结果,简单吧

URL 表达式 Link (URL) expressions: @{...}

例如:<a th:href="@{/order/list}">...</a>
带参数的URL:<a th:href="@{/order/details(id=${orderId},type=${orderType})}">...</a>
相对地址:<a th:href="@{../documents/report}">...</a>
绝对地址:<a th:href="@{http://www.mycompany.com/main}">...</a>

代码段表达式 Fragment expressions: ~{...}

用于整段内容的引用。
例如:<div th:insert="~{commons :: main}">...</div>

整体的例子:

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

详细介绍:https://github.com/thymeleaf/thymeleaf/issues/451


2.2 文字和操作

  • 文本字面量: ‘some text‘
  • 数值字面量: 0, 34, 3.0, 12.3
  • 布尔值字面量: true, false
  • Null 值字面量: null
  • Tokens 字面量: one, content, sometext, ...

文本操作符

  • 字符串连接: +

比如附加字符:<span th:text="‘The name of the user is ‘ + ${user.name}">

  • 字面量替换: |The name is ${name}|

字面量替换主要用于连接字符,比如<span th:text="|The name of the user is ${user.name}|">就和上面的一样

算术操作符

  • 二元操作符: +, -, *, /, %
  • 负数(一元操作符): -

布尔操作符(逻辑操作符)

  • 二元操作符: and, or
  • 非(一元操作符): !, not

比较操作符

  • 比较: >, <, >=, <= (gt, lt, ge, le)
  • 相等性: ==, != (eq, ne)

条件操作符

  • if-then: (if) ? (then)
  • if-then-else: ‘(if) ? (then) : (else)‘
  • 默认: (value) ?: (defaultvalue)

2.3 特殊符号

忽略操作 No-Operation token: _

例子:<div id="main" th:text="${data.hasId()} ? ${data.value} : _">...</div>

如变量${data.hasId()} == true ,则输出类似:<div id="main" text="模型的value值">...</div>
如变量${data.hasId()} == false ,则输出类似:<div id="main">...</div>

解耦模板逻辑 Decoupled Template Logic

见:https://github.com/thymeleaf/thymeleaf/issues/465

转义

比如<p th:text="‘man, <br>Let\‘s</br> fish!‘"></p>
因为Let‘s包含 ‘ , 得用 \ 进行转义
输出:man, <br>Let‘s</br> fish!

非转义文本 Unescaped Text

假如配置文件为:home.welcome=Welcome to our <b>fantastic</b> grocery store!
直接使用会造成问题,输出:<p>Welcome to our &lt;b&gt;fantastic&lt;/b&gt; grocery store!</p>
使用th:utext可以解决问题,如:
<p th:utext="#{home.welcome}"></p>

输出就是fantastic加粗体的文本:<p>Welcome to our <b>fantastic</b> grocery store!</p>
记得非转义文本用th:utext,不要用th:text哦

预处理表达式

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

看上去很乱是吧,实际上可以分解成3步
1、先计算变量${sel.code},假如值是welcome
2、__的含义是需要预处理的变量值,那么就变成#{home.welcome}
3、计算最终结果,简单吧

默认处理表达式 Default expressions (Elvis operator)

如果变量为空或者不满足then条件,就用默认值,如:

<p>Age: <span th:text="*{age}?: ‘(no age specified)‘">27</span>.</p>

等同:

<p>Age: <span th:text="*{age != null}? *{age} : ‘(no age specified)‘">27</span>.</p>

 

3 数据遍历

使用th:each属性

<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>

其中iterStat用于定义遍历的状态,比如是奇数还是偶数(iterStat.odd是奇)iterStat.even是偶数。
还有其他的属性:

  • index :当前迭代索引,从0开始。这是索引属性。
  • count :当前迭代索引,从1开始。这是计数属性。
  • size :迭代变量中的元素总数。这是尺寸的属性。
  • current :iter变量用于每次迭代。这是当前属性。
  • even/odd :当前迭代是偶数还是奇数。这些是偶/奇布尔性质。
  • first :当前迭代是否是第一次迭代。这是第一个布尔属性。
  • last :当前迭代是否为最后一次迭代。这是最后一个布尔属性。

条件if表达式

<table>
<tr>
<th>NAME</th>
<th>PRICE</th>
<th>IN STOCK</th>
<th>COMMENTS</th>
</tr>
<tr th:each="prod : ${prods}" th:class="${prodStat.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>
<td>
<span th:text="${#lists.size(prod.comments)}">2</span> comment/s
<a href="comments.html" 
th:href="@{/product/comments(prodId=${prod.id})}" 
th:if="${not #lists.isEmpty(prod.comments)}">view</a>
</td>
</tr>
</table>

 

使用th:switch替代if

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

 

Thymeleaf教程入门到深入1:基础介绍

标签:list   empty   ase   with   mode   教程   freemark   展示   3.0   

原文地址:https://www.cnblogs.com/starcrm/p/9295838.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!