Thymeleaf循環詳解

Thymeleaf是一款伺服器端的Java模板引擎，適用於Web和獨立環境。它的設計著重於開發的高效性和可讀性。循環是Thymeleaf中最常用的功能之一，它使得在模板中表現數據變得更加簡單和直觀。本篇文章將從多個方面介紹Thymeleaf循環的使用。

一、List的循環

循環List是Thymeleaf中最常用和基礎的循環之一，它能夠快速地遍歷List中所有元素，並將每個元素展示在模板中。下面是List循環的代碼示例：

<table>
  <thead>
    <tr>
      <th>Name</th>
      <th>Age</th>
      <th>Phone</th>
    </tr>
  </thead>
  <tbody>
    <tr th:each="person : ${people}">
      <td th:text="${person.name}">Name</td>
      <td th:text="${person.age}">Age</td>
      <td th:text="${person.phone}">Phone</td>
    </tr>
  </tbody>
</table>

在上述代碼中，我們使用了th:each指令來循環遍歷people這個List。而在循環體中，使用th:text指令將person對象中的name、age和phone屬性輸出到HTML表格中對應的單元格中。

二、數組的循環

除了List以外，數組也是Thymeleaf中常用的循環對象。它的使用方式與List類似，下面是數組循環的代碼示例：

<div th:each="num : ${numbers}">
  <span th:text="${num}">1</span>
</div>

與List循環不同的是，數組循環中的變數需要使用「:」符號，如「num : ${numbers}」中的「num」就是循環體中的變數。同時，循環體中需要使用th:text指令將數組元素輸出到HTML中。

三、循環語法

Thymeleaf的循環語法比較簡單，只需要使用th:each指令即可完成循環。該指令的語法如下：

th:each="item : ${list}"

其中，「item」是循環體中的變數名，「${list}」是要循環遍歷的對象。當多重循環時，可以添加多個th:each指令，如：

<div th:each="group : ${groups}">
  <h2 th:text="${group.name}">Group</h2>
  <ul>
    <li th:each="person : ${group.people}">
      <span th:text="${person.name}">Name</span>,
      <span th:text="${person.age}">Age</span>,
      <span th:text="${person.phone}">Phone</span>
    </li>
  </ul>
</div>

上述代碼中，我們展示了如何在模板中進行多重循環。我們首先使用th:each指令遍歷groups，接著在循環體中使用th:each指令遍歷group對象中的people。最後，將人員信息輸出到HTML中。

四、遍歷序號

在一些場景下，可能需要在循環過程中累加計數。Thymeleaf提供了th:each指令中的「index」和「count」變數，用於記錄當前元素的位置和累加的計數。下面是如何使用這兩個變數的代碼示例：

<div th:each="person, index : ${people}">
  <p th:text="${index.count}+'-'+${person.name}">1 - John Smith</p>
</div>

在上述代碼中，我們使用「index.count」和「index.index」分別表示當前元素的累計數量和位置。同時，我們結合使用th:text指令輸出當前元素的位置和name屬性。

五、遍歷次數

在一些場景下，可能需要在循環結束後統計出循環的次數。Thymeleaf提供了th:count指令來實現該功能。該指令的語法如下：

th:count="${{datas.list.size()}}"

其中，「${{datas.list.size()}}」表示需要統計的循環次數。使用該指令時，需要開啟thymeleaf的「thymeleaf-extras-java8time」擴展包。下面是使用th:count指令的代碼示例：

<div th:each="person : ${people}">
  <p th:text="${person.name}" th:count="${{people.size()}}">John Smith</p>
</div>

在上述代碼中，我們使用th:count指令將循環的次數統計出來，並使用th:text指令輸出了person對象中的name屬性。

六、無序列表的遍歷

除了在表格中展示數據外，循環可能在其他場景下也是很有用的。下面是如何使用Thymeleaf循環遍歷無序列表的代碼示例：

<ul>
  <li th:each="item : ${items}">
    <span th:text="${item}">List Item</span>
  </li>
</ul>

在上述代碼中，我們使用th:each指令遍歷items，並在循環體中將每個元素都展示為一個列表項。

七、循環生成指定的標籤

循環不僅可以用來展示數據，還可以用來生成HTML標籤。下面是如何使用Thymeleaf循環來生成指定標籤的代碼示例：

<th:block th:each="i : ${#numbers.sequence(1,5)}">
   <th:block th:text="${i}" th:tag="${'h'+i}">1</th:block>
</th:block>

在上述代碼中，我們使用th:each指令遍歷1-5的數值，並結合th:text和th:tag指令生成了h1-h5標籤。

八、使用Map進行循環

除了List和數組，Thymeleaf中還支持使用Map進行循環。下面是如何使用Map進行循環的代碼示例：

<ul>
  <li th:each="value : ${map}">
    <span th:text="${value.key}">Key</span>:
    <span th:text="${value.value}">Value</span>
  </li>
</ul>

在上述代碼中，我們使用th:each指令遍歷map，並使用th:text指令將key和value輸出到HTML中。