Thymeleaf的学习笔记整理
2015-06-15 14:23
253 查看
首先 Thymeleaf 是个什么东西?
简单说, Thymeleaf
是一个跟 Velocity、FreeMarker 类似的模板引擎,它可以完全替代 JSP 。相较与其他的模板引擎,它有如下三个极吸引人的特点:
1.Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持
html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以静态地运行;当有数据返回到页面时,Thymeleaf 标签会动态地替换掉静态内容,使页面动态显示。
2.Thymeleaf 开箱即用的特性。它提供标准和spring标准两种方言,可以直接套用模板实现JSTL、
OGNL表达式效果,避免每天套模板、该jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
3. Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块,可以快速的实现表单绑定、属性编辑器、国际化等功能。
(一)Thymeleaf 基础
1. Thymeleaf 是基于 XML 标签和执行 DOM(文本对象模型)预定义逻辑的属性,而不是直接在模板写逻辑代码。开发者只需要将标签属性添加到模板中,这些标签属性就会在DOM上执行预定义的逻辑。它允许处理如下六种模板模式:
- XML
- Valid XML
- XHTML
- Valid XHTML
- HTML5
- Legacy HTML5
2. 标准表达式摘要
Thymeleaf
的数据访问,我们称之为标准表达式。下面一起看一下这些标准表达式:
1)简单表达式
a)变量表达式
${……}
<input type="text" name="userName" value="James
Carrot" th:val
4000
ue="${user.name}" />
引用user对象的name属性变量
b)选择/星号表达式
*{……}
<div th:object="${session.user}">
<p>Nationality: <span th:text="*{nationality}">Saturn</span>.</p>
</div>
选择表达式一般跟在th:object后,直接取object中的属性。
c)文字国际化表达式 #{……}
<p th:utext="#{home.welcome}">Welcome
to our grocery store!</p>
调用国际化的welcome语句
d)URL表达式
@{……}
<a href="details.html"
th:href="@{/order/details(orderId=${o.id})}">view</a>
@{……}支持决定路径和相对路径。其中相对路径又支持跨上下文调用url和协议的引用(//code.jquery.com/jquery-2.0.3.min.js)。
2)文字
a)文本文字 'one text','Another one',……
b)数字文字 0,34,3.0,12.3,……
c)布尔文字 true,flase
d)空文字 null
e)文字标记 one,sometext,main,……
3)文本处理
a)字符串连接 +
b)文字替换 | The name id ${name} |
4)算术表达式
a)基本表达式 +,-,*,/,%
b)减号(一元运算符) -
5)布尔表达式
a)基本表达式 and,or
b)布尔否定(一元运算符) !,not
6)比较和相等
a)比较 >,<,>=,<=(gt,lt,ge,le)
b)相等表达式 ==,!=(eq,ne)
7)条件表达式
a)If-then (if) ? (then)
b)If-then-else (if) ? (then) : (else)
c)Default (value) ? : (defaltvalue)
所有这些标签能够结合和嵌套:
User is of type ' + (${user.isAdmin()} ? 'Administrator' : (${user.type} ?: 'Unknown'))
3.表达式基本对象
在上下文变量评估OGNL表达式时,一些对象表达式可获得更高的灵活性。这些对象将由#号开始引用。
- #ctx: 上下文对象.
- #vars: 上下文变量.
- #locale: 上下文语言环境.
- #httpServletRequest: (仅在web上文)HttpServletRequest 对象.
- #httpSession: (仅在web上文) HttpSession 对象.
4.表达式功能对象
- #dates:java.util.Date对象的实用方法。
- #calendars:和dates类似, 但是 java.util.Calendar 对象.
- #numbers: 格式化数字对象的实用方法。
- #strings: 字符创对象的实用方法: contains, startsWith, prepending/appending等.
- #objects: 对objects操作的实用方法。
- #bools: 对布尔值求值的实用方法。
- #arrays: 数组的实用方法。
- #lists: list的实用方法。
- #sets: set的实用方法。
- #maps: map的实用方法。
- #aggregates: 对数组或集合创建聚合的实用方法。
- #messages: 在表达式中获取外部信息的实用方法。
- #ids: 处理可能重复的id属性的实用方法 (比如:迭代的结果)。
5.给特定的属性设值
下面是用th:action给action设值。
<form
action="subscribe.html" th:action="@{/subscribe}">
还有很多这样的属性,它们每一个都针对一个特定的XHTML或者HTML5属性:
th:text="${data}"
将data的值替换该属性所在标签的body。字符常量要用引号,比如th:text="'hello world'",th:text="2011+3",th:text="'my
name is '+${user.name}"
th:utext
和th:text的区别是"unescaped text"。
th:with
定义变量,th:with="isEven=${prodStat.count}%2==0",定义多个变量可以用逗号分隔。
th:attr
设置标签属性,多个属性可以用逗号分隔,比如th:attr="src=@{/image/aa.jpg},title=#{logo}",此标签不太优雅,一般用的比较少。
th:[tagAttr]
设置标签的各个属性,比如th:value,th:action等。
可以一次设置两个属性,比如:th:alt-title="#{logo}"
对属性增加前缀和后缀,用th:attrappend,th:attrprepend,比如:th:attrappend="class=${' '+cssStyle}"
对于属性是有些特定值的,比如checked属性,thymeleaf都采用bool值,比如th:checked=${user.isActive}
th:each
循环,<tr th:each="user,userStat:${users}">,userStat是状态变量,有 index,count,size,current,even,odd,first,last等属性,如果没有显示设置状态变量, thymeleaf会默 认给个“变量名+Stat"的状态变量。
th:if or th:unless
条件判断,支持布尔值,数字(非零为true),字符,字符串等。
th:switch,th:case
选择语句。 th:case="*"表示default case。
~~! 本文有引用http://www.blogjava.net/bjwulin/archive/2013/02/07/395234.html博客部分内容。
简单说, Thymeleaf
是一个跟 Velocity、FreeMarker 类似的模板引擎,它可以完全替代 JSP 。相较与其他的模板引擎,它有如下三个极吸引人的特点:
1.Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持
html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以静态地运行;当有数据返回到页面时,Thymeleaf 标签会动态地替换掉静态内容,使页面动态显示。
2.Thymeleaf 开箱即用的特性。它提供标准和spring标准两种方言,可以直接套用模板实现JSTL、
OGNL表达式效果,避免每天套模板、该jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
3. Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块,可以快速的实现表单绑定、属性编辑器、国际化等功能。
(一)Thymeleaf 基础
1. Thymeleaf 是基于 XML 标签和执行 DOM(文本对象模型)预定义逻辑的属性,而不是直接在模板写逻辑代码。开发者只需要将标签属性添加到模板中,这些标签属性就会在DOM上执行预定义的逻辑。它允许处理如下六种模板模式:
- XML
- Valid XML
- XHTML
- Valid XHTML
- HTML5
- Legacy HTML5
2. 标准表达式摘要
Thymeleaf
的数据访问,我们称之为标准表达式。下面一起看一下这些标准表达式:
1)简单表达式
a)变量表达式
${……}
<input type="text" name="userName" value="James
Carrot" th:val
4000
ue="${user.name}" />
引用user对象的name属性变量
b)选择/星号表达式
*{……}
<div th:object="${session.user}">
<p>Nationality: <span th:text="*{nationality}">Saturn</span>.</p>
</div>
选择表达式一般跟在th:object后,直接取object中的属性。
c)文字国际化表达式 #{……}
<p th:utext="#{home.welcome}">Welcome
to our grocery store!</p>
调用国际化的welcome语句
d)URL表达式
@{……}
<a href="details.html"
th:href="@{/order/details(orderId=${o.id})}">view</a>
@{……}支持决定路径和相对路径。其中相对路径又支持跨上下文调用url和协议的引用(//code.jquery.com/jquery-2.0.3.min.js)。
2)文字
a)文本文字 'one text','Another one',……
b)数字文字 0,34,3.0,12.3,……
c)布尔文字 true,flase
d)空文字 null
e)文字标记 one,sometext,main,……
3)文本处理
a)字符串连接 +
b)文字替换 | The name id ${name} |
4)算术表达式
a)基本表达式 +,-,*,/,%
b)减号(一元运算符) -
5)布尔表达式
a)基本表达式 and,or
b)布尔否定(一元运算符) !,not
6)比较和相等
a)比较 >,<,>=,<=(gt,lt,ge,le)
b)相等表达式 ==,!=(eq,ne)
7)条件表达式
a)If-then (if) ? (then)
b)If-then-else (if) ? (then) : (else)
c)Default (value) ? : (defaltvalue)
所有这些标签能够结合和嵌套:
User is of type ' + (${user.isAdmin()} ? 'Administrator' : (${user.type} ?: 'Unknown'))
3.表达式基本对象
在上下文变量评估OGNL表达式时,一些对象表达式可获得更高的灵活性。这些对象将由#号开始引用。
- #ctx: 上下文对象.
- #vars: 上下文变量.
- #locale: 上下文语言环境.
- #httpServletRequest: (仅在web上文)HttpServletRequest 对象.
- #httpSession: (仅在web上文) HttpSession 对象.
4.表达式功能对象
- #dates:java.util.Date对象的实用方法。
- #calendars:和dates类似, 但是 java.util.Calendar 对象.
- #numbers: 格式化数字对象的实用方法。
- #strings: 字符创对象的实用方法: contains, startsWith, prepending/appending等.
- #objects: 对objects操作的实用方法。
- #bools: 对布尔值求值的实用方法。
- #arrays: 数组的实用方法。
- #lists: list的实用方法。
- #sets: set的实用方法。
- #maps: map的实用方法。
- #aggregates: 对数组或集合创建聚合的实用方法。
- #messages: 在表达式中获取外部信息的实用方法。
- #ids: 处理可能重复的id属性的实用方法 (比如:迭代的结果)。
5.给特定的属性设值
下面是用th:action给action设值。
<form
action="subscribe.html" th:action="@{/subscribe}">
还有很多这样的属性,它们每一个都针对一个特定的XHTML或者HTML5属性:
th:text="${data}"
将data的值替换该属性所在标签的body。字符常量要用引号,比如th:text="'hello world'",th:text="2011+3",th:text="'my
name is '+${user.name}"
th:utext
和th:text的区别是"unescaped text"。
th:with
定义变量,th:with="isEven=${prodStat.count}%2==0",定义多个变量可以用逗号分隔。
th:attr
设置标签属性,多个属性可以用逗号分隔,比如th:attr="src=@{/image/aa.jpg},title=#{logo}",此标签不太优雅,一般用的比较少。
th:[tagAttr]
设置标签的各个属性,比如th:value,th:action等。
可以一次设置两个属性,比如:th:alt-title="#{logo}"
对属性增加前缀和后缀,用th:attrappend,th:attrprepend,比如:th:attrappend="class=${' '+cssStyle}"
对于属性是有些特定值的,比如checked属性,thymeleaf都采用bool值,比如th:checked=${user.isActive}
th:each
循环,<tr th:each="user,userStat:${users}">,userStat是状态变量,有 index,count,size,current,even,odd,first,last等属性,如果没有显示设置状态变量, thymeleaf会默 认给个“变量名+Stat"的状态变量。
th:if or th:unless
条件判断,支持布尔值,数字(非零为true),字符,字符串等。
th:switch,th:case
选择语句。 th:case="*"表示default case。
~~! 本文有引用http://www.blogjava.net/bjwulin/archive/2013/02/07/395234.html博客部分内容。
相关文章推荐
- myTemplate模板引擎
- TMDPHP 模板引擎使用教程
- 浅谈轻量级js模板引擎simplite
- 常用的JavaScript模板引擎介绍
- Discuz 模板引擎的封装类代码
- freemarker 数字格式化深入理解
- PHP模板引擎smarty详细介绍
- laytpl 精致巧妙的JavaScript模板引擎
- smarty模板引擎基础知识入门
- smarty模板引擎之分配数据类型
- ThinkPHP模板引擎之导入资源文件方法详解
- Laravel模板引擎Blade中section的一些标签的区别介绍
- SpringMVC文件上传 多文件上传实例
- java Spring整合Freemarker的详细步骤
- Freemarker常用指令使用示例
- JAVA velocity模板引擎使用实例
- spring mvc4的日期/数字格式化、枚举转换示例
- CodeIgniter模板引擎使用实例
- smarty模板引擎之内建函数用法
- Python Web开发模板引擎优缺点总结