libedi / spring-thymeleaf-sample

spring-thymeleaf-sample

1. Thymeleaf의 특징

• Thymeleaf는 JSP와 같이 서블릿 의존성이 없어 Natural Template이 가능.
• Thymeleaf는 JSTL의 요소기반과 다르게 속성기반이라 Natural Template이 가능.
• 때문에 디자인 팀과의 협업이 수월하고, HTML파일이라 바로 실행 가능.
• HTML5 지원 및 Spring Framework와의 호환성이 강점. (SpEL, Spring Dialect 지원으로 확장기능 제공)
• Spring Boot에서 적극적으로 지원. (Auto-Configuration이 잘 되어있어 별다른 설정없이 사용가능)
• fragment 기능을 이용하여 ajax 템플릿으로도 사용가능.

2. Syntax : Thymeleaf Document

2.1. Text Binding - 참고소스 : text.html

• <p th:text="${text}">Basic Text Binding</p>
• <p th:utext="${escapeText}">Unescape Text Binding</p>
• <p th:text="'This is a' + ${text}">String Concatenation</p>
• <p th:text="#{message.source}">Load Message Source</p>
• <p th:text="#{message.source('param')}">Load Message Source with Parameter</p>

2.2. Loop - 참고소스 : loop.html

• <tr th:each="item,status: ${list}">
<td th:text="'index: ' + ${status.index} + ', name: ' + ${item.name}"></td>
</tr>
• status
  • index : zero-based current index
  • count : one-based current index
  • size
  • current
  • even/odd : Whether the current iteration is even or odd. boolean value
  • first : Whether the current iteration is the first one. boolean value
  • last : Whether the current iteration is the last one. boolean value

2.3. Condition - 참고소스 : condition.html

• <p th:if="${trueCondition}">Display</p>
• <p th:if="${falseCondition}">Not Display</p>
• <p th:unless="${falseCondition}">Display</p>
• <p th:unless="${trueCondition}">Not Display</p>
• <div th:switch="${switchCase}">
<p th:case="'case1'">Case1 : Display</p>
<p th:case="'case2'">Case2 : Not Display</p>
<p th:case="*">Default : Not Display</p>
</div>

2.4. Layout - 참고소스 : default.html, header.html, footer.html, layout-content.html

• Dependency 추가 : Spring Boot 사용시 version 관리가 되므로 version은 안적어도 됨.
  • <dependency>
<groupId>nz.net.ultraq.thymeleaf</groupId>
<artifactId>thymeleaf-layout-dialect</artifactId>
<version>2.3.0</version>
</dependency>
• 기본 구성
  • layout을 위한 페이지
  • 공통으로 처리할 페이지 (ex: header/footer/side navigation/etc..)
  • 컨텐츠 페이지

2.5. Date - 참고소스 : date.html

• Java 8에서 추가된 java.time.* 패키지 지원
• Instant를 formatting 하려면 ZoneId가 필요한데, Thymeleaf에서 기본적으로 해당 기능을 제공하지 않는다. 사용하려면 확장필요.
• <p data-th-text="${#dates.format(standardDate, 'yyyy-MM-dd HH:mm:ss')}"></p>
• <p data-th-text="${#temporals.format(localDateTime, 'yyyy-MM-dd HH:mm:ss')}"></p>
• <p data-th-text="${#temporals.format(localDate, 'yyyy-MM-dd')}"></p>
• <p data-th-text="${#temporals.formatISO(timestamp)}"></p>