본문 바로가기
Spring(JAVA Framework)/Spring MVC

Thymeleaf 사용법

by 걸어가는 신사 2021. 9. 19.

1. 타임리프 사용 선언

<html xmlns:th="http://www.thymeleaf.org">

 

2. 속성 변경 - th:href

(1) 핵심

  • th:xxx가 붙은 부분은 서버사이드에서 렌더링 되고, 기존 것을 대체한다. th:xxx이 없으면 기존 html의 xxx속성이 그대로 사용된다.
  • HTML을 파일로 직접 열었을 때, th:xxx가 있어도 웹 브라우저는 th: 속성을 알지 못하므로 무시한다.
  • 따라서 HTML을 파일 보기를 유지하면서 템플릿 기능도 할 수 있다.

(2) Example

EX) href="../css/bootstrap.min.css" th:href="@{/css/bootstrap.min.css}"
  • href="value1"을 th:href="value2"의 값으로 변경한다.
  • 타임리프 뷰 템플릿을 거치게 되면 원래 값을 th:xxx값으로 변경한다. 만약 값이 없다면 새로 생성한다.
  • HTML을 그래도 볼 때는 href 속성이 사용되고, 뷰 템플릿을 거치면 th:href의 값이 href로 대체되면서 동적으로 변경
  • 대부분의 HTML 속성을 th:xxx로 변경할 수 있다.

 

3. URL 링크 표현식 - @{....}

EX) th:href="@{/css/bootstrap.min.css}"
  • @{....} : 타임리프는 URL 링크를 사용하는 경우 @{....}를 사용한다. 
  • URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함한다.

 

4. 리터럴 대체 - |....|

  • 타임리프에서 문자와 표현식 등은 분리되어 있기 때문에 더해서 사용해야 한다.
EX) th:onclick="'location.href=' + '\'' + @{/basic/items/add} + '\''"
  • 다음과 같이 리터럴 대체 문법을 사용하면, 더하기 없이 편리하게 사용 가능하다.
EX) th:onclick="|location.href='@{/basic/items/add}'|"

 

5. 반복 출력 - th:each

EX) <tr th:each="item : ${items}">
  • 반복은 th:each를 사용한다. 이렇게 하면 모델에 포함된 items 컬렉션 데이터가 item 변수에 하나씩 포함되고, 반복문 안에서 item 변수를 사용할 수 있다.
  • 컬렉션 수만큼 <tr>..</tr>이 하위 태그를 포함해서 생성된다.

 

6. 변수 표현식 - ${....}

EX) <td th:text="${item.price}">10000</td>
  • 모델에 포함된 값이나, 타임리프 변수로 선언한 값을 조회할 수 있다.
  • 프로퍼티 접근법을 사용한다. (item.getPrice())

 

7. 내용 변경 - th:text

EX) <td th:text="${item.price}">10000</td>
  • 내용의 값을 th:text의 값으로 변경한다.
  • 10000이 ${item.price} 의 값으로 변경된다.

 

8. URL 링크 표현식 2 - @{....}

(1) 변수 표현식 사용

EX) th:href="@{/basic/items/{itemId}(itemId=${item.id})}"
  • 상품 ID를 선택하는 링크를 확인해보자.
  • URL 링크 표현식을 사용하면 경로를 템플릿처럼 편리하게 사용할 수 있다.
  • 경로 변수({itemId}) 뿐만 아니라 쿼리 파라미터도 생성한다.
EX) th:href="@{/basic/items/{itemId}(itemId=${item.id}, query='test')}"
  • 생성 링크 : http://localhost:8080/basic/items/1?query=test

(2) 리터럴 대체 문법을 사용

EX) th:href="@{|/basic/items/${item.id}|}"
  • 리터럴 대체 문법을 활용해서 간단히 사용할 수 있다. 
반응형

'Spring(JAVA Framework) > Spring MVC' 카테고리의 다른 글

HTTP Message Converter  (0) 2021.09.18
HTTP Response  (0) 2021.09.18
HTTP Request - (2) (feat. Request Message Body)  (0) 2021.09.17
HTTP Request - (1) (feat. Request Parameter)  (0) 2021.09.16
@RequestMapping  (0) 2021.09.15

댓글