在現代的Web開發中，前后端分離已經成為一種趨勢，但在某些場景下，服務器端渲染（SSR）仍然有其獨特的優勢。Thymeleaf作為一種流行的Java模板引擎，能夠與Spring Boot無縫集成，幫助開發者快速構建動態網頁。本文將詳細介紹如何在Spring Boot項目中使用Thymeleaf模板引擎。
Thymeleaf是一個現代化的服務器端Java模板引擎，適用于Web和獨立環境。它能夠處理HTML、XML、JavaScript、CSS甚至純文本。Thymeleaf的主要目標是提供一種優雅且高度可維護的模板創建方式。
首先，我們需要創建一個Spring Boot項目?？梢允褂肧pring Initializr（https://start.spring.io/）快速生成項目骨架。選擇以下依賴：
生成項目后，導入到IDE中。
Spring Boot默認已經配置了Thymeleaf，因此我們無需進行額外的配置。如果需要自定義配置，可以在application.properties或application.yml中進行設置。
# application.properties
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.cache=false
在src/main/resources/templates目錄下創建一個HTML文件，例如index.html。
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Thymeleaf Example</title>
</head>
<body>
<h1 th:text="${message}">Default Message</h1>
</body>
</html>
在這個模板中，我們使用了Thymeleaf的th:text屬性來動態設置<h1>標簽的內容。
接下來，我們需要創建一個Spring MVC控制器來處理請求并返回模板。
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class ThymeleafController {
@GetMapping("/")
public String index(Model model) {
model.addAttribute("message", "Hello, Thymeleaf!");
return "index";
}
}
在這個控制器中，我們使用@GetMapping注解將根路徑/映射到index方法。index方法將一個名為message的屬性添加到Model中，并返回模板名稱index。
啟動Spring Boot應用程序，訪問http://localhost:8080/，你將看到頁面顯示“Hello, Thymeleaf!”。
Thymeleaf支持多種表達式，包括變量表達式、選擇表達式、消息表達式等。
${...}，用于訪問模型中的變量。*{...}，用于選擇當前對象的屬性。#{...}，用于國際化消息。@{...}，用于生成URL。Thymeleaf支持條件判斷，可以使用th:if和th:unless屬性。
<div th:if="${user.isAdmin}">
<p>Welcome, Admin!</p>
</div>
<div th:unless="${user.isAdmin}">
<p>Welcome, User!</p>
</div>
Thymeleaf支持循環，可以使用th:each屬性。
<ul>
<li th:each="item : ${items}" th:text="${item}">Item</li>
</ul>
Thymeleaf提供了強大的表單處理功能，可以使用th:object和th:field屬性。
<form th:object="${user}" th:action="@{/save}" method="post">
<input type="text" th:field="*{name}" />
<input type="text" th:field="*{email}" />
<button type="submit">Save</button>
</form>
Thymeleaf支持模板片段，可以使用th:fragment和th:replace屬性。
<!-- fragments/header.html -->
<header th:fragment="header">
<h1>My Website</h1>
</header>
<!-- index.html -->
<div th:replace="~{fragments/header :: header}"></div>
Thymeleaf支持布局，可以使用th:insert和th:replace屬性。
<!-- layout.html -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Layout</title>
</head>
<body>
<div th:replace="~{fragments/header :: header}"></div>
<div th:insert="~{${content}}"></div>
<div th:replace="~{fragments/footer :: footer}"></div>
</body>
</html>
<!-- index.html -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Index</title>
</head>
<body>
<div th:replace="~{layout :: layout(content=~{::content})}">
<div th:fragment="content">
<p>This is the content.</p>
</div>
</div>
</body>
</html>
Thymeleaf支持國際化，可以使用#{...}表達式和th:text屬性。
<p th:text="#{welcome.message}">Welcome</p>
Thymeleaf與Spring Security集成，可以使用sec:authorize屬性進行權限控制。
<div sec:authorize="hasRole('ADMIN')">
<p>Admin only content</p>
</div>
Thymeleaf支持自定義方言，可以通過實現IProcessor接口來擴展Thymeleaf的功能。
Thymeleaf是一個功能強大且靈活的模板引擎，能夠與Spring Boot無縫集成，幫助開發者快速構建動態網頁。通過本文的介紹，你應該已經掌握了如何在Spring Boot項目中使用Thymeleaf模板引擎，并了解了其常用功能和高級特性。希望本文能幫助你在實際項目中更好地使用Thymeleaf。
免責聲明：本站發布的內容（圖片、視頻和文字）以原創、轉載和分享為主，文章觀點不代表本網站立場，如果涉及侵權請聯系站長郵箱：is@yisu.com進行舉報，并提供相關證據，一經查實，將立刻刪除涉嫌侵權內容。
