<em>Mac</em>Book项目 2009年学校开始实施<em>Mac</em>Book项目,所有师生配备一本<em>Mac</em>Book,并同步更新了校园无线网络。学校每周进行电脑技术更新,每月发送技术支持资料,极大改变了教学及学习方式。因此2011
2021-06-01 09:32:01
Thymeleaf是面向Web和獨立環境的現代伺服器Java模板引擎,能夠處理HTML,XML,JavaScript,CSS甚至純文字。
Thymeleaf旨在提供一個優雅的、高度可維護的建立模板的方式。為了實現這一目標,Thymeleaf建立在自然模板的概念上,將其邏輯注入到模板檔案中,不會影響模板設計原型。這改善了設計的溝通,彌合了設計和開發團隊之間的差距。
Thymeleaf從設計之初就遵循Web標準——特別是HTML5標準,如果需要,Thymeleaf允許建立完全符合HTML5驗證標準的模板。
通過Maven新建一個名為springboot-thymeleaf
的專案。
1.引入依賴
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Thymeleaf 起步依賴 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <!-- lombok外掛 --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.8</version> </dependency>
2.編寫組態檔
spring: thymeleaf: # 在構建URL時用於檢視名稱的字首,預設為classpath:/templates/ prefix: classpath:/templates/ # 在構建URL時附加到檢視名稱的字尾,預設為.html suffix: .html # 模板模式,預設為HTML mode: HTML # 模板檔案編碼,預設為UTF-8 encoding: UTF-8 # 是否啟用模板快取,預設為true,表示啟用,false不啟用 cache: false # 在呈現模板之前是否檢查模板存在與否,預設為true check-template: true # 是否檢查模板位置存在與否,預設為true check-template-location: true
更多的設定可以檢視ThymeleafProperties
類:
3.準備模板
首先按照組態檔中設定的模板字首在resources
下建立一個templates
目錄,用於存放模板。然後建立如下名為hello.html
的模板:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Hello Thymeleaf</title> </head> <body> <div> <span th:text="${hello}">th:text文字替換會跳脫html標籤,不解析html</span> </div> <hr/> <div> <span th:utext="${hello}">th:utext文字替換不會跳脫html標籤,會解析html</span> </div> </body> </html>
<html>
標籤中的xmlns:th="http://www.thymeleaf.org
宣告使用Thymeleaf標籤。th:text
屬性會計算表示式的值將結果設定為標籤的標籤體。但它會跳脫HTML標籤,HTML標籤會直接顯示在瀏覽器上。th:utext
屬性不會跳脫HTML標籤,HTML標籤會被瀏覽器解析。${hello}
是一個變數表示式,它包含一個OGNL(Object-Graph Navigation Language)的表示式,它會從上下文中獲取名為hello
的變數,然後在模板上進行渲染。
4.Controller層
建立Controller並將模板中要獲取的變數設定到Model物件中,如果Controller類上使用的是@Controller
註解,則可以返回跟模板名稱相同的字串(不包括字首和字尾),檢視解析器會解析出檢視具體地址並生成檢視,然後返回給前端控制器進行渲染:
package com.rtxtitanv.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; /** * @author rtxtitanv * @version 1.0.0 * @name com.rtxtitanv.controller.ThymeleafController * @description ThymeleafController * @date 2021/7/3 19:23 */ @Controller public class ThymeleafController { @GetMapping("/hello") public String hello(Model model) { model.addAttribute("hello", "<h1>Hello Thymeleaf</h1>"); return "hello"; } }
執行專案,瀏覽器存取http://localhost:8080/hello,發現資料成功渲染到模板:
如果Controller類上使用的是@RestController
註解,則需要將檢視新增到ModelAndView物件中並返回:
package com.rtxtitanv.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.servlet.ModelAndView; /** * @author rtxtitanv * @version 1.0.0 * @name com.rtxtitanv.controller.TestController * @description TestController * @date 2021/7/3 19:43 */ @RequestMapping("/test") @RestController public class TestController { @GetMapping("/hello") public ModelAndView hello() { ModelAndView modelAndView = new ModelAndView("hello"); modelAndView.addObject("hello", "<h1>hello thymeleaf</h1>"); return modelAndView; } }
執行專案,瀏覽器存取http://localhost:8080/test/hello,發現資料成功渲染到模板:
1.標準表示式
(1)變數表示式
${}
表示式實際上是在上下⽂中包含的變數的對映上執行的OGNL(Object-Graph Navigation Language)物件。例如:${session.user.name}
。
在Spring MVC啟用的應用程式中,OGNL將被替換為SpringEL,但其語法與OGNL相似(實際上,在大多數常見情況下完全相同)。
模板variable.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>變數表示式</title> </head> <body> <p>變數表示式:${}</p> <div> <p>id: <span th:text="${user.id}"></span></p> <p>username: <span th:text="${user.username}"></span></p> <p>password: <span th:text="${user.password}"></span></p> </div> </body> </html>
User實體類:
package com.rtxtitanv.model; import lombok.AllArgsConstructor; import lombok.Data; import lombok.NoArgsConstructor; /** * @author rtxtitanv * @version 1.0.0 * @name com.rtxtitanv.model.User * @description User * @date 2021/7/3 19:37 */ @AllArgsConstructor @NoArgsConstructor @Data public class User { private Long id; private String username; private String password; }
ThymeleafController
中新增以下方法:
@GetMapping("/variable") public String variable(Model model) { model.addAttribute("user", new User(1L, "趙雲", "qwe123")); return "variable"; }
效果:
在${}
表示式中還可以使用基本物件和工具類物件。這些物件都以#
開頭。基本物件:
#ctx
:上下文物件。#vars
:上下文變數。#locale
:上下文區域設定。#request
:(僅在Web Contexts中)HttpServletRequest物件。#response
:(僅在Web上下⽂中)HttpServletResponse物件。#session
:(僅在Web上下⽂中)HttpSession物件。#servletContext
:(僅在Web上下⽂中)ServletContext物件。工具類物件:
#execInfo
:有關正在處理的模板的資訊。#messages
:用於在變數表示式中獲取外部化訊息的方法,與使用#{}語法獲取的方式相同。#uris
:跳脫URL/URI部分的方法。#conversions
:執行設定的轉換服務的方法。#dates
:java.util.Date
物件的方法。#calendars
:類似於#dates
,但對應java.util.Calendar
物件。#numbers
:用於格式化數位物件的方法。#strings
:字串物件的方法。#objects
:一般物件的方法。#bools
:布林相關方法。#arrays
:Array的方法。#lists
:List的方法。#sets
:Set的方法。#maps
:Map的方法。#aggregates
:在陣列或集合上建立聚合的方法。#ids
:處理可能重複的id屬性的方法。這些物件的詳細方法可以檢視官方檔案:https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#appendix-a-expression-basic-objects。
(2)選擇表示式(星號語法)
星號語法*{}
計算所選物件而不是整個上下文的表示式。也就是說,只要沒有選定的物件(選定物件為th:object
屬性的表示式結果),$
和*
語法就會完全相同。
模板asterisk.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>選擇表示式(星號語法)</title> </head> <body> <p>*語法</p> <div th:object="${user}"> <p>id: <span th:text="*{id}"></span></p> <p>username: <span th:text="*{username}"></span></p> <p>password: <span th:text="*{password}"></span></p> </div> <p>$語法</p> <div> <p>id: <span th:text="${user.id}"></span></p> <p>username: <span th:text="${user.username}"></span></p> <p>password: <span th:text="${user.password}"></span></p> </div> <p>$和*混合使用</p> <div th:object="${user}"> <p>id: <span th:text="*{id}"></span></p> <p>username: <span th:text="${user.username}"></span></p> <p>password: <span th:text="*{password}"></span></p> </div> <p>物件選擇到位時所選物件將作為#object表示式變數可⽤於$表示式</p> <div th:object="${user}"> <p>id: <span th:text="${#object.id}"></span></p> <p>username: <span th:text="${user.username}"></span></p> <p>password: <span th:text="*{password}"></span></p> </div> <p>沒有執⾏物件選擇時$和*語法等效</p> <div> <p>id: <span th:text="*{user.id}"></span></p> <p>username: <span th:text="*{user.username}"></span></p> <p>password: <span th:text="*{user.password}"></span></p> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/asterisk") public String star(Model model) { model.addAttribute("user", new User(1L, "趙雲", "qwe123")); return "asterisk"; }
效果:
(3)URL表示式
URL表示式的語法為@{}
。使用th:href
屬性可以對連結進行渲染。
模板url.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>URL表示式</title> </head> <body> <ol> <li><a href="user/one.html" rel="external nofollow" rel="external nofollow" th:href="@{/user/one(id=${user.id})}" rel="external nofollow" >設定單個引數</a></li> <li><a href="user/list.html" rel="external nofollow" th:href="@{/user/list(username=${user.username},password=${user.password})}" rel="external nofollow" >設定多個引數</a></li> <li><a href="user/one.html" rel="external nofollow" rel="external nofollow" th:href="@{/user/one/{id}(id=${user.id})}" rel="external nofollow" >URL路徑中也允許使⽤變數模板(rest風格引數)</a></li> <li><a href="user/update.html" rel="external nofollow" th:href="@{${url}(id=${user.id})}" rel="external nofollow" >URL基數也可以是計算另⼀個表示式的結果</a></li> <li><a href="store/user/update.html" rel="external nofollow" th:href="@{'/store' + ${url}(id=${user.id})}" rel="external nofollow" >url基數也可以是計算另⼀個表示式的結果</a></li> </ol> <hr/> <!-- th:action設定表單提交地址 --> <form id="login-form" th:action="@{/hello}"> <button>提交</button> </form> </body> </html>
注意:
th:href
屬性會計算要使用的URL並將該值設定為<a>
標籤的href
屬性。URL中允許使用表示式的URL引數,設定多個引數將以,
分隔。
URL路徑中也可以使用變數模板,即可以設定rest風格的引數。/
開頭的相對URL將自動以應用上下文名稱為字首。如果cookie未啟用或還未知道,可能會在相對URL中新增;jsessionid=...
字尾以便保留對談。這被稱為URL重寫。
th:href
屬性允許在模板中有一個靜態的href
屬性,這樣在直接開啟原型模板時,模板連結可以被導航。
ThymeleafController
中新增以下方法:
@GetMapping("/url") public String url(Model model) { model.addAttribute("user", new User(1L, "趙雲", "qwe123")); model.addAttribute("url", "/user/update"); return "url"; }
效果:
從上到下依次點選5個連結和提交表單的結果:
(4)字面量
字面量(Literals)分為:
模板literal.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>字面量</title> </head> <body> <div> <ul> <li> <p><span>文字文字:</span><span th:text="'Hello World'">⽂本文字只是包含在單引號之間的字串,可以包含任何字元,其中的單引號需要'跳脫</span></p> </li> <li> <p><span>數位字面量:</span><span th:text="2020 + 1">數位字面量就是數位</span></p> </li> <li> <p><span>布林字面量:</span><span th:if="${flag} == false">布林字⾯量包含true和false</span></p> </li> <li> <p><span>null字面量:</span><span th:if="${flag} != null">Thymeleaf標準表示式語法中也可以使⽤null字⾯量</span></p> </li> <li> <p><span>文字元號:</span><span th:text="Hello_.-._World">數位,布林和null字面量實際上是⽂本符號的特殊情況</span></p> </li> </ul> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/literal") public String literal(Model model) { model.addAttribute("flag", false); return "literal"; }
效果:
(5)文字操作
這裡的文字操作包含:
+
運運算元進行拼接。+
,這些替換必需用|
包圍。使用字面替換也可以實現和追加文字相同的效果。模板text.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>文字操作(字串連線)</title> </head> <body> <div> <ul> <li> <p><span>方式1(+):</span><span th:text="'username: ' + ${user.username} + ', password: ' + ${user.password}"></span></p> </li> <li> <p><span>方式2(|):</span><span th:text="|username: ${user.username}, password: ${user.password}|"></span></p> </li> <li> <!-- 只有變數或訊息表示式(${},*{},#{})才允許包含在||中 --> <p><span>方式3(+與|混合):</span><span th:text="'username: ' + ${user.username} + |, password: ${user.password}|"></span></p> </li> <li> <p><span>方式4(#strings.concat):</span><span th:text="${#strings.concat('username: ', user.username, ', password: ', user.password)}"></span></p> </li> <li> <p><span>方式5(#strings.append):</span><span th:text="${#strings.append('username: ' + user.username, ', password: ' + user.password)}"></span></p> </li> <li> <p><span>方式6(#strings.prepend):</span><span th:text="${#strings.prepend(', password: ' + user.password, 'username: ' + user.username)}"></span></p> </li> <li> <p><span>方式7(#strings.arrayJoin):</span><span th:text="${#strings.arrayJoin(new String[] {'username: ', user.username, ', password: ', user.password}, '')}"></span></p> </li> </ul> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/text") public String text(Model model) { model.addAttribute("user", new User(1L, "趙雲", "qwe123")); return "text"; }
效果:
(6)運運算元
運運算元:
+
、-
、*
、/
(div
)、%
(mod
)。>
(gt
)、<
(lt
)、>=
(ge
)、<=
(le
)。==
(eq
)、!=
(ne
)。and
、or
、!
(not
)。模板operation.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>運運算元</title> </head> <body> <p th:text="|x=${x}, y=${y}|"></p> <p>算術運運算元:+、-、*、/(div)、%(mod)</p> <div> <ul> <li> <p><span>(y + x % 3) * (y - x / 2) :</span><span th:text="(${y} + ${x} % 3) * (${y} - ${x} / 2)"></span></p> </li> <li> <!-- 運運算元也可以在OGNL變數表示式本身中應⽤(這種情況下由OGNL解析執⾏,⽽不是Thymeleaf標準表示式引擎來解析執⾏) --> <p><span>(x * 5 + 8 div y) mod (x - y) :</span><span th:text="${(x * 5 + 8 div y) mod (x - y)}"></span></p> </li> </ul> </div> <p>比較和等值運運算元:>(gt)、<(lt)、>=(ge)、<=(le)、==(eq)、!=(ne)</p> <div> <ul> <li> <p><span>x > 5:</span><span th:text="${x} > 5"></span></p> </li> <li> <p><span>y le 2:</span><span th:text="${y le 2}"></span></p> </li> <li> <p><span>(x * y) < 50:</span><span th:text="${(x * y) < 50}"></span></p> </li> <li> <p><span>y ge x:</span><span th:text="${y} ge ${x}"></span></p> </li> <li> <p><span>x == y:</span><span th:text="${x == y}"></span></p> </li> <li> <p><span>x ne y:</span><span th:text="${x} ne ${y}"></span></p> </li> </ul> </div> <p>布林運運算元:and、or、!(not)</p> <div> <ul> <li> <p><span>y lt x and -x gt -y:</span><span th:text="${y} lt ${x} and ${-x} gt ${-y}"></span></p> </li> <li> <p><span>-x <= -y or y >= x:</span><span th:text="${-x <= -y or y >= x}"></span></p> </li> <li> <p><span>!(x != y):</span><span th:text="${!(x != y)}"></span></p> </li> <li> <p><span>not (x eq y):</span><span th:text="${not (x eq y)}"></span></p> </li> </ul> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/operation") public String operator(Model model) { model.addAttribute("x", 10); model.addAttribute("y", 3); return "operation"; }
效果:
(7)條件表示式
條件表示式:
(if) ? (then)
。if
表示式結果為true
,則條件表示式結果為then
表示式結果,否則為null。(if) ? (then) : (else)
。if
表示式結果為true
,則條件表示式結果為then
表示式結果,否則為else
表示式結果。(value) ?: (defaultvalue)
。value
不為null,則結果為value
,否則結果為defaultvalue
。模板conditional-expr.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>條件表示式、預設表示式、_符號</title> </head> <body> <p th:text="|grade: ${grade}, age: ${age}|"></p> <div> <ul> <li> <!-- (if) ? (then) : (else) --> <p><span>成績是否及格:</span><span th:text="${grade >= 60} ? '及格' : '不及格'"></span></p> </li> <li> <!-- (if) ? (then),else表示式可以省略,在這種情況下,如果條件為false,則返回null值 --> <p><span>成績是否是正常資料:</span><span th:text="${grade >= 0 and grade <= 100} ? '正常資料'"></span></p> </li> <li> <!-- 條件表示式可以使⽤括號巢狀 --> <p><span>成績對應的級別:</span><span th:text="${grade >= 0 and grade <= 100} ? (${grade >= 60} ? (${grade} >= 70 ? (${grade >= 90} ? '優' : '良') : '差') : '不及格') : '無效資料'"></span></p> </li> <li> <!-- 預設表示式 第一個表示式結果不為null,則結果使用第一個表示式的值,結果為null,則使用第二個表示式 --> <p><span>年齡:</span><span th:text="${age} ?: '沒有年齡資料'"></span></p> </li> <li> <p><span>預設表示式巢狀範例:</span><span th:text="${age} ?: (${grade} ?: '年齡和成績資料都不存在')"></span></p> </li> <li> <!-- _符號指定表示式不處理任何結果,這允許開發⼈員使⽤原型⽂本作為預設值 --> <p><span>年齡:</span><span th:text="${age} ?: _">沒有年齡資料</span></p> </li> </ul> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/conditional/expr") public String conditionExpr(Model model) { model.addAttribute("grade", 85); model.addAttribute("age", null); return "conditional-expr"; }
效果:
grade
設定為-1,age
設定為20。效果如下:
2.設定屬性
使用th:attr
屬性可以設定標籤的任何屬性值,th:attr
只需要通過一個表示式將值賦給對應的屬性,並且還可以通過,
分隔的形式設定多個屬性值。不過使用th:attr
設定屬性不太優雅,所以用的不多,一般使用其他th:*屬性的形式設定指定屬性,例如要設定value
屬性,可以使用th:value
,要設定action
屬性,可以使用th:action
,要設定href
屬性,可以使用th:href
,具體都有哪些屬性可以這樣設定可以參考官方檔案。
th:attrprepend
和th:attrappend
可以給屬性設定字首和字尾。Thymeleaf標準方言中還有兩個特定的附加屬性th:classappend
和th:styleappend
,用於將CSS的class或style樣式追加到元素中,而不覆蓋現有屬性。
HTML中有布林屬性這個概念,布林屬性沒有值,並且一旦這個布林屬性存在則意味著屬性值為true。但是在XHTML中,這些屬性只取它本身作為屬性值。例如checked
屬性。Thymeleaf標準方言允許通過計算條件表示式的結果來設定這些屬性的值,如果條件表示式結果為true,則該屬性將被設定為其固定值,如果評估為false,則不會設定該屬性。
Thymeleaf支援使用HTML5自定義屬性語法data-{prefix}-{name}
來處理模板,這不需要使用任何名稱空間。Thymeleaf使這種語法自動適用於所有的方言(不僅僅是標準的方法)。
模板attr.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>設定屬性</title> </head> <body> <div> <p>設定單個任何屬性:<input type="submit" value="提交" th:attr="value=${success}"></p> <!-- th:attr可以以逗號分隔的形式來設定多個屬性值 --> <p>設定多個任何屬性:<input type="submit" value="提交" th:attr="value=${success},class='btn btn-primary'"></p> <p>設定單個指定屬性:<input type="submit" value="提交" th:value="${success}"></p> <p>設定多個指定屬性:<input type="submit" value="提交" th:value="${success}" th:class="'btn btn-primary'"></p> <!-- th:attrappend設定字尾 --> <p>設定屬性字尾:<input type="submit" value="提交" th:attrappend="value=${' ' + success}"></p> <!-- th:attrprepend設定字首 --> <p>設定屬性字首:<input type="submit" value="提交" th:attrprepend="value=${success + ' '}"></p> <!-- th:classappend追加class樣式 --> <p>追加class樣式:<input type="submit" value="提交" class='btn btn-primary' th:classappend="'btn-warning'"></p> <!-- th:styleappend追加style樣式 --> <p>追加style樣式:<input type="submit" value="提交" style="text-align: left" th:styleappend="'color: green'"></p> <!-- 如果條件表示式結果為true,則該屬性將被設定為其固定值,如果結果為false,則不會設定該屬性 --> <p>設定布林屬性checked:<input type="checkbox" name="active" th:checked="${active}"></p> <!-- data-{prefix}-{name}語法是在HTML5中編寫⾃定義屬性的標準⽅式,不需要使⽤任何名稱空間 Thymeleaf使這種語法自動適用於所有的方言(不僅僅是標準的方法) --> <p>使用HTML5自定義屬性語法來處理模版:<span data-th-text="${success}"></span></p> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/attr") public String attr(Model model) { model.addAttribute("success", "成功"); model.addAttribute("active", true); return "attr"; }
效果:
f12檢視原始碼可見屬性設定成功:
active
設定為false。checkbox沒有選中,檢視原始碼也沒有設定checked
屬性:
3.條件判斷
th:if
屬性可以通過判斷一個條件是否滿足,來決定是否將模板片段顯示在結果中,只有滿足條件才將模板片段顯示在結果中。而th:unless
屬性則正好與th:if
屬性相反。通過th:switch
和th:case
可以在模板中使用一種與Java中的Swicth語句等效的結構有條件地顯示模板內容。
模板conditional.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>條件判斷</title> </head> <body> <p th:text="|age: ${age}, userLevel: ${userLevel}, rank: ${rank}|"></p> <div th:if="${age} >= 18 and ${userLevel} eq 6"> <span>年齡大於18並且使用者等級等於6,則顯示此元素</span> </div> <div th:unless="!(${age} < 18 or ${userLevel} ne 6)"> <span>與if條件判斷相反,年齡小於18或使用者等級不等於6,則顯示此元素</span> </div> <div th:if="'null'"> <span>表示式的值不為null,th:if判定此表示式的值為true</span> </div> <div th:if="null"> <span>表示式的值為null,th:if判定此表示式的值為false</span> </div> <div th:if="${age}"> <span>值是數位並且不為0,判定此表示式的值為true</span> </div> <div th:if="0"> <span>值是數位但為0,判定此表示式的值為false</span> </div> <div th:if="A"> <span>值是一個字元並且不為0,判定此表示式的值為true</span> </div> <div th:if="'string'"> <span>值是一個字串,不是false,off或no,判定此表示式的值為true</span> </div> <div th:if="'false'"> <span>值是字串false,判定此表示式的值為false</span> </div> <div th:if="'off'"> <span>值是字串off,判定此表示式的值為false</span> </div> <div th:if="'no'"> <span>值是字串no,判定此表示式的值為false</span> </div> <hr/> <div th:switch="${rank}"> <span th:case="1">青銅</span> <span th:case="2">白銀</span> <span th:case="3">黃金</span> <span th:case="4">鉑金</span> <span th:case="5">鑽石</span> <span th:case="6">王者</span> <span th:case="*">無段位</span> </div> </body> </html>
注意:
如果表示式的值不為null。(如果表示式的值為null,
th:if
屬性不僅僅以布林值作為判斷條件。它將按照以下規則判定指定的表示式值為true:th:if
判定此表示式的值為false。)
如果值為布林值,則為true。如果值是數位且不為0。
如果值是一個字元且不為0。如果值是一個字串,不是"false",「off"或"no」。
如果值不是布林值,數位,字元或字串。同一個Switch語句中只要第一個
th:case
的值為true,則其他的th:case
屬性將被視為false。Switch語句的default選項指定為th:case=「*」
。
ThymeleafController
中新增以下方法:
@GetMapping("/conditional") public String condition(Model model) { Map<String, Object> map = new HashMap<>(); map.put("age", 10); map.put("userLevel", 6); map.put("rank", 5); model.addAllAttributes(map); return "conditional"; }
效果:
age
設定為20,userLevel
設定為6,rank
設定為0。效果如下:
4.迴圈迭代
使用th:each
屬性可以迭代以下物件:
java.util.Iterable
介面的物件。java.util.Enumeration
介面的物件。java.util.Iterator
介面的物件。其值將被迭代器返回,不需要在記憶體中快取所有值。java.util.Map
介面的物件。迭代map時,迭代變數將是java.util.Map.Entry
型別。(1)迭代List
模板each-list.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>迴圈迭代List</title> </head> <body> <table> <thead> <tr> <th>id</th> <th>username</th> <th>password</th> <th>index</th> <th>count</th> <th>size</th> <th>current</th> <th>even</th> <th>odd</th> <th>first</th> <th>last</th> </tr> </thead> <tbody> <!-- ${users}為迭代表示式或被迭代變數,userStat為狀態變數,user為迭代變數 --> <tr th:each="user,userStat : ${users}"> <td th:text="${user.id}"></td> <td th:text="${user.username}"></td> <td th:text="${user.password}"></td> <!-- 當前迭代索引,從0開始 --> <td th:text="${userStat.index}"></td> <!-- 當前迭代索引,從1開始 --> <td th:text="${userStat.count}"></td> <!-- 被迭代變數中元素總數 --> <td th:text="${userStat.size}"></td> <!-- 每次迭代的迭代變數 --> <td th:text="${userStat.current}"></td> <!-- 布林值,當前迭代是否是奇數,從0算起 --> <td th:text="${userStat.even}"></td> <!-- 布林值,當前迭代是否是偶數,從0算起 --> <td th:text="${userStat.odd}"></td> <!-- 布林值,當前迭代是否是第一個 --> <td th:text="${userStat.first}"></td> <!-- 布林值,當前迭代是否是最後一個 --> <td th:text="${userStat.last}"></td> </tr> </tbody> </table> </body> </html>
狀態變數是在使用
th:each
時Thymeleaf提供的一種用於跟蹤迭代狀態的機制。狀態變數在th:each
屬性中通過在迭代變數之後直接寫其名稱來定義,用,
分隔。與迭代變數一樣,狀態變數的作用範圍也是th:each
屬性所在標籤定義的程式碼片段中。如果沒有顯式地設定狀態變數,Thymeleaf總是會建立一個名為迭代變數名加上Stat
字尾的狀態變數。
ThymeleafController
中新增以下方法:
@GetMapping("/each/list") public String eachList(ModelMap model) { List<User> users = new ArrayList<>(); users.add(new User(1L, "劉備", "123132")); users.add(new User(2L, "關羽", "321231")); users.add(new User(3L, "張飛", "213312")); model.addAttribute("users", users); return "each-list"; }
效果:
(2)迭代Map
模板each-map.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>迴圈迭代Map</title> </head> <body> <table> <thead> <tr> <th>id</th> <th>username</th> <th>password</th> <th>key</th> <th>index</th> <th>count</th> <th>size</th> <th>current</th> <th>even</th> <th>odd</th> <th>first</th> <th>last</th> </tr> </thead> <tbody> <tr th:each="map,mapStat : ${userMap}"> <td th:text="${mapStat.current.value.id}"></td> <td th:text="${mapStat.current.value.username}"></td> <td th:text="${mapStat.current.value.password}"></td> <td th:text="${mapStat.current.key}"></td> <td th:text="${mapStat.index}"></td> <td th:text="${mapStat.count}"></td> <td th:text="${mapStat.size}"></td> <td th:text="${mapStat.current}"></td> <td th:text="${mapStat.even}"></td> <td th:text="${mapStat.odd}"></td> <td th:text="${mapStat.first}"></td> <td th:text="${mapStat.last}"></td> </tr> </tbody> </table> <hr/> <table> <thead> <tr> <th>id</th> <th>username</th> <th>password</th> <th>key</th> <th>index</th> <th>count</th> <th>size</th> <th>current</th> <th>even</th> <th>odd</th> <th>first</th> <th>last</th> </tr> </thead> <tbody> <tr th:each="map,mapStat : ${userMap}"> <td th:text="${map.value.id}"></td> <td th:text="${map.value.username}"></td> <td th:text="${map.value.password}"></td> <td th:text="${map.key}"></td> <td th:text="${mapStat.index}"></td> <td th:text="${mapStat.count}"></td> <td th:text="${mapStat.size}"></td> <td th:text="${mapStat.current}"></td> <td th:text="${mapStat.even}"></td> <td th:text="${mapStat.odd}"></td> <td th:text="${mapStat.first}"></td> <td th:text="${mapStat.last}"></td> </tr> </tbody> </table> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/each/map") public String eachMap(Model model) { Map<String, Object> map = new HashMap<>(16); map.put("user1", new User(1L, "劉備", "123132")); map.put("user2", new User(2L, "關羽", "321231")); map.put("user3", new User(3L, "張飛", "213312")); model.addAttribute("userMap", map); return "each-map"; }
效果:
(3)迭代Array
模板each-array.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>迴圈迭代Array</title> </head> <body> <table> <thead> <tr> <th>id</th> <th>username</th> <th>password</th> <th>index</th> <th>count</th> <th>size</th> <th>current</th> <th>even</th> <th>odd</th> <th>first</th> <th>last</th> </tr> </thead> <tbody> <!-- ${users}為迭代表示式或被迭代變數,userStat為狀態變數,user為迭代變數 --> <tr th:each="user,userStat : ${users}"> <td th:text="${user.id}"></td> <td th:text="${user.username}"></td> <td th:text="${user.password}"></td> <!-- 當前迭代索引,從0開始 --> <td th:text="${userStat.index}"></td> <!-- 當前迭代索引,從1開始 --> <td th:text="${userStat.count}"></td> <!-- 被迭代變數中元素總數 --> <td th:text="${userStat.size}"></td> <!-- 每次迭代的迭代變數 --> <td th:text="${userStat.current}"></td> <!-- 布林值,當前迭代是否是奇數,從0算起 --> <td th:text="${userStat.even}"></td> <!-- 布林值,當前迭代是否是偶數,從0算起 --> <td th:text="${userStat.odd}"></td> <!-- 布林值,當前迭代是否是第一個 --> <td th:text="${userStat.first}"></td> <!-- 布林值,當前迭代是否是最後一個 --> <td th:text="${userStat.last}"></td> </tr> </tbody> </table> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/each/array") public String eachArray(Model model) { User[] users = {new User(1L, "劉備", "123132"), new User(2L, "關羽", "321231"), new User(3L, "張飛", "213312")}; model.addAttribute("users", users); return "each-array"; }
效果:
5.模板佈局
(1)參照模板片段
th:fragment
屬性可以用來定義模板片段,th:insert
、th:replace
和th:include
(Thymeleaf3.0不再推薦使用)屬性可以參照模板片段。
首先建立一個名為footer.html
的模板檔案用來包含模板片段,然後定義一個名為copy1
的片段:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>footer</title> </head> <body> <div th:fragment="copy1"> © 2021 </div> </body> </html>
然後在名為layout.html
的模板中參照該片段:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>參照模板片段</title> </head> <body> <div th:insert="~{footer :: copy1}"></div> <div th:replace="~{footer :: copy1}"></div> <div th:include="~{footer :: copy1}"></div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/layout") public String layout(Model model) { return "layout"; }
效果:
參照模板片段語法中的~{}
是可選的,以下程式碼與之前的等價:
<div th:insert="footer :: copy1"></div> <div th:replace="footer :: copy1"></div> <div th:include="footer :: copy1"></div>
效果:
th:insert
、th:replace
和th:include
都能參照模板片段,直接在頁面中還看不出三者的區別。為了更明顯地看出區別,在footer.html
模板中新增以下片段:
<footer th:fragment="copy2" > © 2020-2023 </footer>
然後在layout.html
模板中分別使用th:insert
、th:replace
和th:include
進行參照:
<div th:insert="footer :: copy2">th:insert將指定片段插⼊到指定宿主標籤的標籤體中</div> <div th:replace="footer :: copy2">th:replace實際上⽤指定的⽚段替換其宿主標籤</div> <div th:include="footer :: copy2">th:include只插⼊此⽚段的內容到指定宿主標籤的標籤體中</div>
效果:
按F12檢視原始碼可以看出區別:
所以三者區別為:
th:insert
將指定片段插入到指定宿主標籤的標籤體中。th:replace
實際上用指定的片段替換其宿主標籤。th:include
只插入此片段的內容到指定宿主標籤的標籤體中。參照模板片段的規範語法有以下三種格式:
~{templatename::selector}
:包含在名為templatename的模板上通過指定的selector匹配的片段。selector可以只是一個片段名稱。~{templatename}
:包含名為templatename的整個模板。~{::selector}
或~{this::selector}
:包含在同一模板中與指定selector匹配的片段。如果在表示式出現的模板上沒有找到,模板呼叫(插入)的堆疊會向最初處理的模板(root)遍歷,直到selector在某個層次上匹配。templatename和selector都可以是表示式。模板片段中可以包含任何th:*屬性,一旦在目標模板中參照了片段,這些屬性將被計算並且它們能夠參照目標模板中定義的任何上下文變數。
通過th:replace="~{footer}"
可以參照整個footer.html
:
<div th:replace="~{footer}">參照名為footer的整個模板</div>
效果:
在layout.html
模板中新增以下幾個片段:
<div th:fragment="frag"> <p>~{:: selector}或~{this :: selector}包含在同⼀模板中的匹配指定選擇器的⽚段</p> </div> <div> <p>文字輸入框:<input type="text" value="輸入內容"></p> </div> <input type="submit" value="提交">
在layout.html
模板中參照frag和input片段:
<div th:insert="~{:: frag}">參照當前模板中的片段</div> <div th:insert="~{this :: input}">參照當前模板中的片段</div>
效果:
selector寫成一個條件表示式,可以通過條件來決定參照的片段:
<div th:insert="~{footer :: (${flag} ? copy1 : copy2)}">模板名和選擇器都可以是表示式</div>
將變數flag
設定到Model中:
model.addAttribute("flag", true);
效果:
flag
設定為fasle時的效果:
由於標籤選擇器的強大功能,沒有使用th:fragment
屬性的片段可以通過id
屬性來參照。在footer.html
模板中新增以下片段:
<div id="copy-section"> <p>沒有使用th:fragment屬性的片段可以通過id屬性來參照</p> </div>
在layout.html
模板中參照該片段:
<div th:insert="~{footer :: #copy-section}">可以通過id屬性來引⽤沒有th:fragment屬性的⽚段</div>
效果:
(2)引數化的模板片段
th:fragment
定義的片段可以指定一組引數。在footer.html
模板中新增以下片段:
<div th:fragment="frag (var1,var2)"> <p th:text="${var1} + ' - ' + ${var2}">th:fragment定義的⽚段可以指定⼀組引數</p> </div>
在layout.html
模板中分別用以下兩種語法參照該片段:
<!-- 參照定義了引數的模板片段的兩種語法 --> <div th:insert="footer :: frag (${var1},${var2})">參照定義了引數的模板片段語法1</div> <div th:insert="footer :: frag (var1=${var1},var2=${var2})">參照定義了引數的模板片段語法2,可以改變引數順序</div>
將變數var1
和var2
設定到Model中:
model.addAttribute("var1", "引數1"); model.addAttribute("var2", "引數2");
效果:
即使片段沒有定義引數,也可以呼叫片段中的區域性變數。在footer.html
模板中新增以下片段:
<div th:fragment="frag2"> <p th:text="${var1} + ' * ' + ${var2}">沒有定義引數的模板片段</p> </div>
在layout.html
模板中分別通過以下語法呼叫片段中的區域性變數:
<!-- 沒有定義引數的模板片段中的區域性變數,可以使用以下語法呼叫,以下兩種寫法等價 --> <div th:insert="footer :: frag2 (var1=${var1},var2=${var2})">沒有定義引數的模板片段中的區域性變數的呼叫語法1</div> <div th:insert="footer :: frag2" th:with="var1=${var1},var2=${var2}">沒有定義引數的模板片段中的區域性變數的呼叫語法2</div>
參照定義引數的模板片段的兩種語法中,第一種語法不能呼叫沒有定義引數的片段中的區域性變數,只有第二種語法能呼叫。
注意:片段的區域性變數規範 - 無論是否具有引數簽名 - 都不會導致上下文在執行前被清空。片段仍然能存取呼叫模板中正在使用的每個上下文變數。
效果:
使用th:assert
可以進行模板內部斷言,它可以指定逗號分隔的表示式列表,如果每個表示式的結果都為true,則正確執行,否則引發異常。在footer.html
模板中新增以下片段:
<div th:fragment="assert-test (user)" th:assert="${user.id != null},${!#strings.isEmpty(user.username)},${!#strings.isEmpty(user.password)}"> <p th:text="${#strings.toString(user)}">⽤th:assert進⾏模版內部斷⾔ </p> </div>
在layout.html
模板中參照該片段:
<!-- 參照帶有斷言的模板片段 --> <div th:insert="footer :: assert-test (${user})"></div>
將變數user
設定到Model中:
model.addAttribute("user", new User(1L, "趙雲", "qwe123"));
效果:
只將id設定為null,存取模板出現以下異常:
只將username設定為空,存取模板出現以下異常:
只將password設定為空,存取模板出現以下異常:
(3)靈活佈局
通過片段表示式不僅可以指定文字型別、數位型別、物件型別的引數,還可以指定標記片段作為引數。這種方式可以使模板佈局變得非常靈活。
下面進行一個頁面佈局的簡單模擬測試,首先在templates
下新建一個layout
目錄,用於存放一些元件模板。
layout/footer.html
:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>footer</title> </head> <body> <footer th:fragment="footer"> <h1>模板佈局頁面頁尾</h1> </footer> </body> </html>
layout/header.html
:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>header</title> </head> <body> <header th:fragment="header"> <h1>模板佈局頁面頭部</h1> </header> </body> </html>
layout/left.html
:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>left</title> </head> <body> <div th:fragment="left"> <h1>模板佈局頁面左側選單</h1> </div> </body> </html>
在templates
下新建一個基礎模板base.html
:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head th:fragment="common_header (title)"> <meta charset="UTF-8"> <title th:replace="${title}">common title</title> </head> <body> <div th:fragment="common_div (header,left,footer)"> <div th:replace="${header}"><h1>common header</h1></div> <div th:replace="${left}"><h1>common left</h1></div> <p>common content</p> <div th:replace="${footer}"><h1>common footer</h1></div> </div> </body> </html>
然後在名為layout-home.html
的模板中參照base.html
中的片段:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head th:replace="base :: common_header(~{:: title})"> <title>模板佈局主頁</title> </head> <body> <div th:replace="base :: common_div (~{layout/header :: header},~{layout/left :: left},~{layout/footer :: footer})"></div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/layout/home") public String layoutHome(Model model) { return "layout-home"; }
效果:
使用特殊片段表示式~{}
可以指定沒有標記。在layout-home.html
中通過以下程式碼參照base.html
中的片段:
<div th:replace="base :: common_div (~{layout/header :: header},~{layout/left :: left},~{})"></div>
效果:
_
符號也可以用作片段引數。在layout-home.html
中通過以下程式碼參照base.html
中的片段:
<div th:replace="base :: common_div (~{layout/header :: header},~{layout/left :: left},_)"></div>
_
符號導致common_div片段中的th:replace="${footer}"
不被執行,從而該div標籤使用原型文字。
效果:
~{}
和_
符號可以通過簡單優雅的方式實現執行片段的條件插入。在layout-home.html
中通過以下程式碼參照base.html
中的片段:
<div th:replace="base :: common_div (${condition} ? ~{layout/header :: header} : ~{},${condition} ? ~{layout/left :: left} : ~{},${condition} ? ~{layout/footer :: footer} : ~{})"></div>
引數中的每一個
condition
條件可以根據實際業務需求靈活控制。這裡為了測試方便,都使用的相同條件。
將變數condition
設定到Model中:
model.addAttribute("condition", false);
效果:
在layout-home.html
中通過以下程式碼參照base.html
中的片段:
<div th:replace="base :: common_div (${condition} ? ~{layout/header :: header} : _,${condition} ? ~{layout/left :: left} : _,${condition} ? ~{layout/footer :: footer} : _)"></div>
效果:
條件也可以不在引數中進行判斷,還在common_div片段的th:replace
屬性中進行判斷。在layout-home.html
中通過以下程式碼參照base.html
中的片段:
<div th:replace="base :: common_div (~{layout/header :: header},~{layout/left :: left},~{layout/footer :: footer},${condition})"></div>
base.html
中的common_div片段:
<div th:fragment="common_div (header,left,footer,condition)"> <div th:replace="${condition} ? ${header} : _"><h1>Common header</h1></div> <div th:replace="${condition} ? ${left}: _"><h1>Common left</h1></div> <p>Common content</p> <div th:replace="${condition} ? ${footer}: _"><h1>Common footer</h1></div> </div>
效果:
6.區域性變數
Thymeleaf的區域性變數是指定義在模板片段中的變數,該變數的作用域為所在模板片段。th:each
中的迭代變數就是一個區域性變數,作用域為th:each
所在的標籤範圍,可用於該標籤內優先順序低於th:each
的任何其他th:*屬性,可用於該標籤的任何子元素。使用th:with
屬性可以宣告區域性變數。
在local.html
模板中使⽤th:with
屬性宣告區域性變數:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>區域性變數</title> </head> <body> <!-- 使⽤th:with屬性宣告區域性變數 --> <div th:with="user1=${users[0]}"> <span>user1的姓名:</span><span th:text="${user1.username}"></span> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/local") public String local(Model model) { User[] users = {new User(1L, "劉備", "123132"), new User(2L, "關羽", "321231"), new User(3L, "張飛", "213312")}; model.addAttribute("users", users); return "local"; }
效果:
區域性變數只能在宣告的標籤內使用。在local.html
模板中新增以下內容:
<!-- 區域性變數不能在宣告的標籤外使用 --> <div> <span>user1的姓名:</span><span th:text="${user1.username}">張三</span> </div>
存取模板會報錯:
可以同時定義多個區域性變數。在local.html
模板中新增以下內容:
<!-- 使⽤通常的多重賦值語法同時定義多個變數 --> <div th:with="user1=${users[0]},user2=${users[1]}"> <span>user1的姓名:</span><span th:text="${user1.username}"></span> <br/> <span>user2的姓名:</span><span th:text="${user2.username}"></span> </div>
效果:
th:with
屬性允許重⽤在同⼀屬性中定義的變數。在local.html
模板中新增以下內容:
<!-- th:with屬性允許重⽤在同⼀屬性中定義的變數 --> <div> <!-- th:with的優先順序高於th:text --> <span>當前時間:</span><span th:with="now=${#calendars.createNow()}" th:text="${#calendars.format(now, 'yyyy/MM/dd hh:mm:ss')}"></span> </div>
效果:
7.屬性優先順序
多個th:*屬性在同一個標籤中的執行順序由優先順序決定。所有Thymeleaf屬性都定義了一個數位優先順序,以確定了它們在標籤中執行的順序,數位越小優先順序越高:
Order | Feature | Attributes |
---|---|---|
1 | Fragment inclusion | th:insert th:replace |
2 | Fragment iteration | th:each |
3 | Conditional evaluation | th:if th:unless th:switch th:case |
4 | Local variable definition | th:object th:with |
5 | General attribute modification | th:attr th:attrprepend th:attrappend |
6 | Specific attribute modification | th:value th:href th:src ... |
7 | Text (tag body modification) | th:text th:utext |
8 | Fragment specification | th:fragment |
9 | Fragment removal | th:remove |
優先順序意味著屬性位置發生變化,也會得出相同的結果。
8.註釋和塊
(1)標準HTML/XML註釋
標準HTML/XML註釋<!-- -->
可以在Thymeleaf模板中的任何地方使用。這些註釋中的任何內容都不會被Thymeleaf處理,並將逐字複製到結果中。
這裡直接執行專案存取local.html
模板,檢視模板原始碼可見HTML註釋沒有被處理,保持原樣:
(2)ThymeLeaf解析器級註釋
解析器級註釋塊<!--/* */-->
在Thymeleaf解析時會將<!--/
和*/-->
之間的所有內容從模板中刪除。當此模板靜態開啟時,這些註釋塊可用於顯示程式碼。
修改local.html
模板的其中一個註釋為如下內容:
<!--/* <div> <span>user1的姓名:</span><span th:text="${user1.username}">張三</span> </div>*/-->
檢視原始碼可見註釋已從模板中刪除:
(3)Thymeleaf專有註釋
Thymeleaf允許定義特殊註釋塊<!--/*/ /*/-->
,在Thymeleaf解析時會將<!--/*/
和/*/-->
標記刪除,但不刪除標記之間的內容。當此模板靜態開啟時,會顯示註釋標記。
修改local.html
模板的其中一個註釋為如下內容:
<!--/*/ <div th:with="user1=${users[0]}"> <span>user1的姓名:</span><span th:text="${user1.username}"></span> </div>/*/-->
檢視原始碼發現只刪除了標記部分,中間的內容保留:
(4)th:block標籤
th:block
標籤是Thymeleaf標準方言中唯一的元素處理器。th:block
是一個允許模板開發者指定想要的任何屬性的屬性容器,Thymeleaf會執行這些屬性並讓這個塊消失,但它的內容保留。
模板block.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>th:block</title> </head> <body> <table> <th:block th:each="user : ${users}"> <tr> <td th:text="${user.id}">1</td> <td th:text="${user.username}">root</td> </tr> <tr> <td colspan="2" th:text="${user.password}">root</td> </tr> </th:block> </table> </body> </html>
使用
th:block
可以輕鬆地迭代同級標籤,例如在<table>
中為每個迭代元素建立多個<tr>
時使用th:block
就很簡單。
ThymeleafController
中新增以下方法:
@GetMapping("/block") public String block(Model model) { List<User> users = new ArrayList<>(); users.add(new User(1L, "劉備", "123132")); users.add(new User(2L, "關羽", "321231")); users.add(new User(3L, "張飛", "213312")); model.addAttribute("users", users); return "block"; }
效果:
檢視原始碼:
在和原型註釋塊結合時很有用:
<table> <!--/*/ <th:block th:each="user : ${users}"> /*/--> <tr> <td th:text="${user.id}">1</td> <td th:text="${user.username}">root</td> </tr> <tr> <td colspan="2" th:text="${user.password}">root</td> </tr> <!--/*/ </th:block> /*/--> </table>
效果:
9.內聯 (1)內聯表示式
[[]]
或[()]
中的表示式為內聯表示式,可以直接將表示式寫入HTML文字。任何在th:text
或th:utext
屬性中使用的表示式都可以出現在[[]]
或[()]
中。[[]]
等價於th:text
,會跳脫html標籤;[()]
等價於th:utext
,不會跳脫html標籤。
模板inline.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>內聯</title> </head> <body> <h1>th:text和th:utext</h1> <p>Hello <span th:text="${user.username}">World</span> !</p> <p>Hello <span th:utext="${user.username}">World</span> !</p> <h1>內聯表示式</h1> <!-- 會跳脫html標籤,等價於th:text --> <p>Hello [[${user.username}]] !</p> <!-- 不會跳脫html標籤,等價於th:utext --> <p>Hello [(${user.username})] !</p> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/inline") public String inline(Model model) { model.addAttribute("user", new User(1L, "<b>趙雲</b>", "this is "pass" word")); return "inline"; }
效果:
注意,靜態開啟模板檔案時,內聯表示式會顯示出來,這樣就無法將其作為原型設計了。靜態開啟inline.html
模板的效果如下:
在有些情況下可能需要禁用內聯,比如需要輸出[[]]序列時。通過th:inline="none"
可以禁用內聯。在模板inline.html
中新增以下內容:
<p>這是一個二維陣列:[[1, 2, 3], [4, 5]]</p>
存取模板時會報如下錯誤:
在剛才的程式碼中增加禁用內聯:
<h2>禁用內聯</h2> <p th:inline="none">這是一個二維陣列:[[1, 2, 3], [4, 5]]</p>
效果:
(2)內聯JavaScript
使用th:inline="javascript"
啟用內聯JavaScript。
在模板inline.html
中新增以下內容:
<h1>內聯JavaScript</h1> <div> <span><button onclick="showPassword()">按鈕</button></span> </div>
<script type="text/javascript" th:inline="javascript"> let password = [[${user.password}]]; console.log("password:", password); function showPassword() { alert(password); } </script>
效果:
檢視原始碼,可見輸出的字串進行了跳脫,是格式正確的JavaScript字串,因為使用[[]]
在輸出${user.password}
表示式的時候進行了跳脫:
檢視Console中列印的紀錄檔:
註釋掉let password = [[${user.password}]];
,新增let password = [(${user.password})];
。檢視原始碼,由於[()]
不會進行跳脫,可見輸出的字串沒有跳脫,是格式錯誤的JavaScript程式碼:
檢視Console,發現有語法錯誤:
如果通過附加內聯表示式的方式來構建指令碼的一部分,可能會需要輸出未跳脫的字串,所以這個功能也很有用。
內聯JavaScript可以通過在註釋中包含內聯表示式作為JavaScript自然模板。下面註釋掉let password = [(${user.password})];
,新增如下程式碼:
// 在JavaScript註釋中包含(跳脫)內聯表示式,Thymeleaf將忽略在註釋之後和分號之前的所有內容 let password = /*[[${user.password}]]*/ "default password";
檢視原始碼:
檢視Console中列印的紀錄檔:
發現"default password"
確實被忽略了。以靜態方式開啟模板時變數password
的值就為"default password"
了:
JavaScript內聯表示式結果不限於字串,還會自動地將Strings、Numbers、Booleans、Arrays、Collections、Maps、Beans(有getter和setter方法)這些物件序列化為JavaScript物件。下面在Controller中新增以下程式碼:
Map<String, Object> map = new HashMap<>(16); map.put("user1", new User(1L, "劉備", "123132")); map.put("user2", new User(2L, "關羽", "321231")); map.put("user3", new User(3L, "張飛", "213312")); model.addAttribute("userMap", map);
script
標籤內新增以下程式碼,Thymeleaf會將userMap物件轉換為JavaScript物件:
// userMap為一個Map物件,Thymeleaf會將其轉換為JavaScript物件 let userMap = /*[[${userMap}]]*/ null; console.log("userMap:", userMap); // 遍歷userMap for (let key in userMap) { console.log(key + ": " + "{id: " + userMap[key].id + ", username: " + userMap[key].username + ", password: " + userMap[key].password + "}"); }
檢視原始碼發現Thymeleaf已經將其轉換為JavaScript物件:
檢視Console中列印的紀錄檔:
(3)內聯CSS
使用th:inline="css"
啟用內聯CSS。
在模板inline.html
中新增以下內容:
<style type="text/css" th:inline="css"> [[${element}]] { text-align: [[${align}]]; color: [[${color}]]; } </style>
將變數element
、align
和color
設定到Model中:
model.addAttribute("element", "h1"); model.addAttribute("align", "center"); model.addAttribute("color", "#2876A7");
存取模板,對齊生效,顏色未生效:
檢視原始碼,發現color的值多了一個:
這是由於[[]]
會進行跳脫,所以多了一個。這裡不需要對其跳脫,所以需要使用
[()]
。將程式碼修改為color: [(${color})];
。存取模板,發現樣式都生效了:
檢視原始碼,沒有多出了:
內聯CSS也允許通過在註釋中包含內聯表示式作為CSS自然模板,使CSS可以靜態和動態的工作。將<style>
的程式碼修改為如下內容:
<style type="text/css" th:inline="css"> h1 { text-align: /*[[${align}]]*/ left; color: /*[(${color})]*/ #B60d16; } </style>
模板動態開啟時的效果:
檢視原始碼:
以靜態方式開啟的效果:
檢視原始碼:
10.國際化
這裡簡單模擬一下國際化功能,通過語言切換應用對應語言的國際化組態檔。
(1)建立國際化組態檔
在resources/i18n
目錄下建立如下組態檔。
index.properties
:
user.register=註冊 user.login=登入 index.language=語言 index.language.chinese=中文 index.language.english=英文
index_en_US.properties
:
user.register=Register user.login=Login index.language=Language index.language.chinese=Chinese index.language.english=English
index_zh_CN.properties
:
user.register=註冊 user.login=登入 index.language=語言 index.language.chinese=中文 index.language.english=英文
(2)新增設定
在application.yml
中新增以下設定:
spring: messages: # 設定訊息源的基本名稱,預設為messages,這裡設定為國際化組態檔的字首 basename: i18n.index
(3)建立模板
模板i18n.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>國際化</title> </head> <body> <div> <span><button th:text="#{user.register}">註冊</button></span> <span><button th:text="#{user.login}">登入</button></span> <span th:text="#{index.language}">語言</span> <a th:href="@{/index(lang='zn_CN')}" th:text="#{index.language.chinese}">中文</a> <a th:href="@{/index(lang='en_US')}" th:text="#{index.language.english}">英文</a> </div> </body> </html>
#{}
為訊息表示式,用於參照訊息字串。而訊息字串通常儲存在外部化文字中,訊息字串形式為key=value,通過#{key}
可以參照特定的訊息。而根據不同的語言從與其對應的外部化文字中獲取同一個key的訊息,可以實現國際化。
(4)設定國際化解析器
package com.rtxtitanv.config; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.LocaleResolver; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import org.thymeleaf.util.StringUtils; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.util.Locale; /** * @author rtxtitanv * @version 1.0.0 * @name com.rtxtitanv.config.WebConfig * @description 設定自定義國際化解析器 * @date 2021/7/6 16:25 */ @Configuration public class WebConfig implements WebMvcConfigurer { @Bean public LocaleResolver localeResolver() { return new MyLocaleResolver(); } /** * 自定義LocaleResolver */ public static class MyLocaleResolver implements LocaleResolver { @Override public Locale resolveLocale(HttpServletRequest request) { // 接收語言引數 String lang = request.getParameter("lang"); // 使用預設語言 Locale locale = Locale.getDefault(); // 語言引數不為空就設定為該語言 if (!StringUtils.isEmptyOrWhitespace(lang)) { String[] s = lang.split("_"); locale = new Locale(s[0], s[1]); } return locale; } @Override public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {} } }
(5)Controller
@GetMapping(value = {"/index", "/"}) public String index() { return "i18n"; }
(5)測試
存取模板,預設語言為中文:
點選英文連結切換語言為英文:
點選中文連結切換語言為中文:
11.常用工具類物件
之前在文中已經簡單地總結了Thymeleaf中的工具類物件和它的作用。這裡結合範例來總結一下常用工具類物件具體方法的使用,由於工具類物件較多,這裡就總結Dates、Numbers和Strings的具體使用方法。至於其他物件的方法,可以參考官方檔案。
(1)Dates
模板date.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>工具類物件Dates</title> </head> <body> <div> <span>格式化日期格式1(format):</span> <span th:text="${#dates.format(date)}"></span> <br/> <span>格式化日期格式2(format):</span> <span th:text="${#dates.format(date, 'yyyy/MM/dd hh:mm:ss')}"></span> <br/> <span>獲取年(year):</span> <span th:text="${#dates.year(date)}"></span> <br/> <span>獲取月(month):</span> <span th:text="${#dates.month(date)}"></span> <br/> <span>獲取日(day):</span> <span th:text="${#dates.day(date)}"></span> <br/> <span>獲取時(hour):</span> <span th:text="${#dates.hour(date)}"></span> <br/> <span>獲取分(minute):</span> <span th:text="${#dates.minute(date)}"></span> <br/> <span>獲取秒(second):</span> <span th:text="${#dates.second(date)}"></span> <br/> <span>獲取毫秒(millisecond):</span> <span th:text="${#dates.millisecond(date)}"></span> <br/> <span>獲取月份名稱(monthName):</span> <span th:text="${#dates.monthName(date)}"></span> <br/> <span>獲取星期索引,1為星期日,2為星期1,···,7為星期六(dayOfWeek):</span> <span th:text="${#dates.dayOfWeek(date)}"></span> <br/> <span>獲取星期名稱(dayOfWeekName):</span> <span th:text="${#dates.dayOfWeekName(date)}"></span> <br/> <span>建立當前date和time(createNow):</span> <span th:text="${#dates.createNow()}"></span> <br/> <span>建立當前date,time設定為00:00(createToday):</span> <span th:text="${#dates.createToday()}"></span> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/dates") public String dates(Model model) { model.addAttribute("date", new Date()); return "dates"; }
效果:
(2)Numbers
模板number.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>工具類物件Numbers</title> </head> <body> <div> <span>整數格式化 - 設定最小整數位數為3(formatInteger):</span> <span th:text="${#numbers.formatInteger(num, 3)}"></span> <br/> <span>整數格式化 - 設定最小整數位數為6(formatInteger):</span> <span th:text="${#numbers.formatInteger(num, 6)}"></span> <br/> <span>整數格式化 - 設定千位分隔符為.(formatInteger):</span> <span th:text="${#numbers.formatInteger(num, 6, 'POINT')}"></span> <br/> <span>整數格式化 - 設定千位分隔符為,(formatInteger):</span> <span th:text="${#numbers.formatInteger(num, 6, 'COMMA')}"></span> <br/> <span>整數陣列格式化(arrayFormatInteger):</span> <span th:each="element:${#numbers.arrayFormatInteger(nums, 6)}">[[${element}]] </span> <br/> <span>小數格式化 - 設定最小整數位數為5且精確保留3位小數位數(formatDecimal)</span> <span th:text="${#numbers.formatDecimal(num2, 5, 3)}"></span> <br/> <span>小數格式化 - 設定千位分隔符為.且小數點分隔符為,(formatDecimal)</span> <span th:text="${#numbers.formatDecimal(num2, 5, 'POINT', 3, 'COMMA')}"></span> <br/> <span>貨幣格式化(formatCurrency):</span> <span th:text="${#numbers.formatCurrency(num)}"></span> <br/> <span>百分比格式化 - 設定最小整數位數為2且精確保留3位小數(formatPercent):</span> <span th:text="${#numbers.formatPercent(0.25831694, 2, 3)}"></span> <br/> <span>建立整數數位序列 - 序列從1到10步長為3(sequence):</span> <span th:each="n:${#numbers.sequence(1, 10, 3)}">[[${n}]] </span> <br/> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/numbers") public String numbers(Model model) { Integer[] numArray = {1000, 666, 88888}; model.addAttribute("num", 99999); model.addAttribute("num2", 66.6658932); model.addAttribute("nums", numArray); return "numbers"; }
效果:
(3)Strings
模板strings.html
如下:
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>工具類物件Strings</title> </head> <body> <div> <span>字串轉換(toString):</span> <span th:text="${#strings.toString(user)}"></span> <br/> <span>檢查字串是否為空(isEmpty):</span> <span th:text="${#strings.isEmpty(user.username)}"></span> <br/> <span>字串為空時使用預設值(defaultString):</span> <span th:text="${#strings.defaultString(user.password, 'admin')}"></span> <br/> <span>檢查字串是否以指定片段開頭(startsWith):</span> <span th:text="${#strings.startsWith(user.username, 'Spring')}"></span> <br/> <span>檢查字串是否以指定片段結尾(endsWith):</span> <span th:text="${#strings.endsWith(user.username, 'test')}"></span> <br/> <span>檢查字串是否包含指定片段(contains):</span> <span th:text="${#strings.contains(user.username, 'Thymeleaf')}"></span> <br/> <span>判斷兩個字串是否相等(equals):</span> <span th:text="${#strings.equals(user.username, str)}"></span> <br/> <span>判斷兩個字串是否相等,忽略大小寫(equalsIgnoreCase):</span> <span th:text="${#strings.equalsIgnoreCase(user.username, 'springboot-thymeleaf-strings-test')}"></span> <br/> <span>獲取字串長度(length):</span> <span th:text="${#strings.length(user.username)}"></span> <br/> <span>字串轉換為大寫字母(toUpperCase):</span> <span th:text="${#strings.toUpperCase(user.username)}"></span> <br/> <span>字串轉換為小寫字母(toLowerCase):</span> <span th:text="${#strings.toLowerCase(user.username)}"></span> <br/> <span>片段在字串中的索引(indexOf):</span> <span th:text="${#strings.indexOf(user.username, 'Boot')}"></span> <br/> <span>字串去除空格(trim):</span> <span th:text="${#strings.trim(str)}"></span> <br/> <span>字串省略(abbreviate):</span> <span th:text="${#strings.abbreviate(user.username, 23)}"></span> <br/> <span>字串擷取,從指定索引開始擷取到末尾(substring):</span> <span th:text="${#strings.substring(user.username, 11)}"></span> <br/> <span>字串擷取指定開始索引到結束索引之間的部分,不包含結束索引字元(substring):</span> <span th:text="${#strings.substring(user.username, 11, 20)}"></span> <br/> <span>擷取指定字串第一次出現前的字串(substringBefore):</span> <span th:text="${#strings.substringBefore(user.username, '-')}"></span> <br/> <span>擷取指定字串第一次出現後的字串(substringAfter):</span> <span th:text="${#strings.substringAfter(user.username, '-')}"></span> <br/> <span>字串替換(replace):</span> <span th:text="${#strings.replace(user.username, '-', '_')}"></span> <br/> <span>從字串頭部向前追加(prepend):</span> <span th:text="${#strings.prepend(user.username, '使用者名稱是')}"></span> <br/> <span>從字串尾部向後追加(append):</span> <span th:text="${#strings.append(user.username, '是使用者名稱')}"></span> <br/> <span>字串連線(concat):</span> <span th:text="${#strings.concat(user.username, '-concat')}"></span> <br/> <span>字串連線(concatReplaceNulls):</span> <span th:text="${#strings.concatReplaceNulls(user.username, '使用者名稱是', null, '-concatReplaceNulls')}"></span> <br/> <span>字串拆分(arraySplit):</span> <span th:each="element:${#strings.arraySplit(user.username, '-')}">[[${element}]] </span> <br/> <span>字串組合(arrayJoin):</span> <span th:text="${#strings.arrayJoin(strs, '-')}"></span> <br/> <span>隨機字串(randomAlphanumeric):</span> <span th:text="${#strings.randomAlphanumeric(16)}"></span> </div> </body> </html>
ThymeleafController
中新增以下方法:
@GetMapping("/strings") public String strings(Model model) { model.addAttribute("user", new User(1L, "SpringBoot-Thymeleaf-Strings-Test", "")); model.addAttribute("str", "SpringBoot Thymeleaf Strings Test"); model.addAttribute("strs", new String[] {"SpringBoot", "Thymeleaf", "Strings", "Test"}); return "strings"; }
效果:
程式碼範例
Github:https://github.com/RtxTitanV/springboot-learning/tree/master/springboot2.x-learning/springboot-thymeleaf
到此這篇關於SpringBoot2.x 整合 Thymeleaf的文章就介紹到這了,更多相關SpringBoot2.x 整合 Thymeleaf內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!
相關文章
<em>Mac</em>Book项目 2009年学校开始实施<em>Mac</em>Book项目,所有师生配备一本<em>Mac</em>Book,并同步更新了校园无线网络。学校每周进行电脑技术更新,每月发送技术支持资料,极大改变了教学及学习方式。因此2011
2021-06-01 09:32:01
综合看Anker超能充系列的性价比很高,并且与不仅和iPhone12/苹果<em>Mac</em>Book很配,而且适合多设备充电需求的日常使用或差旅场景,不管是安卓还是Switch同样也能用得上它,希望这次分享能给准备购入充电器的小伙伴们有所
2021-06-01 09:31:42
除了L4WUDU与吴亦凡已经多次共事,成为了明面上的厂牌成员,吴亦凡还曾带领20XXCLUB全队参加2020年的一场音乐节,这也是20XXCLUB首次全员合照,王嗣尧Turbo、陈彦希Regi、<em>Mac</em> Ova Seas、林渝植等人全部出场。然而让
2021-06-01 09:31:34
目前应用IPFS的机构:1 谷歌<em>浏览器</em>支持IPFS分布式协议 2 万维网 (历史档案博物馆)数据库 3 火狐<em>浏览器</em>支持 IPFS分布式协议 4 EOS 等数字货币数据存储 5 美国国会图书馆,历史资料永久保存在 IPFS 6 加
2021-06-01 09:31:24
开拓者的车机是兼容苹果和<em>安卓</em>,虽然我不怎么用,但确实兼顾了我家人的很多需求:副驾的门板还配有解锁开关,有的时候老婆开车,下车的时候偶尔会忘记解锁,我在副驾驶可以自己开门:第二排设计很好,不仅配置了一个很大的
2021-06-01 09:30:48
不仅是<em>安卓</em>手机,苹果手机的降价力度也是前所未有了,iPhone12也“跳水价”了,发布价是6799元,如今已经跌至5308元,降价幅度超过1400元,最新定价确认了。iPhone12是苹果首款5G手机,同时也是全球首款5nm芯片的智能机,它
2021-06-01 09:30:45