본문 바로가기

MVC

[MVC] Thymeleaf 뷰 템플릿

✍ 타임리프 간단히 알아보기

 

✅ 타임리프 사용 선언

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

 


✅ 속성 변경 - th:href

th:href="@{/css/bootstrap.min.css}"

 

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


타임리프 핵심

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

 


✅ URL 링크 표현식 - @{...},

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

 

상품 등록 폼으로 이동
속성 변경 - th:onclick

onclick="location.href='addForm.html'"
th:onclick="|location.href='@{/basic/items/add}'|"
  • 리터럴 대체 문법이 사용되었다

 

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

 

|...| :이렇게 사용한다.


🌟타임리프에서 문자와 표현식 등은 분리되어 있기 때문에 더해서 사용해야 한다.

<span th:text="'Welcome to our application, ' + ${user.name} + '!'">

 

 

다음과 같이 리터럴 대체 문법을 사용하면, 더하기 없이 편리하게 사용할 수 있다.

<span th:text="|Welcome to our application, ${user.name}!|">

 


결과를 다음과 같이 만들어야 하는데

location.href='/basic/items/add'

 


그냥 사용하면 문자와 표현식을 각각 따로 더해서 사용해야 하므로 다음과 같이 복잡해진다.

th:onclick="'location.href=' + '\'' + @{/basic/items/add} + '\''"

 


리터럴 대체 문법을 사용하면 다음과 같이 편리하게 사용할 수 있다.

th:onclick="|location.href='@{/basic/items/add}'|"

 

 

 

✅ 반복 출력 - th:each

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

 


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

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

 


✅ 내용 변경 - th:text

<td th:text="${item.price}">10000</td>
  • 내용의 값을 th:text 의 값으로 변경한다.
  • 여기서는 10000을 ${item.price} 의 값으로 변경한다.

 


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

th:href="@{/basic/items/{itemId}(itemId=${item.id})}"
  • URL 링크 표현식을 사용하면 경로를 템플릿처럼 편리하게 사용할 수 있다.
  • 경로 변수( {itemId} ) 뿐만 아니라 쿼리 파라미터도 생성한다.


쿼리 파라미터 예시 

th:href="@{/basic/items/{itemId}(itemId=${item.id}, query='test')}"
  • 생성 링크: http://localhost:8080/basic/items/1?query=test


URL 링크 간단히

th:href="@{|/basic/items/${item.id}|}"

 

  • 리터럴 대체 문법을 활용해서 간단히 사용할 수도 있다.

 

 

✅ 속성 변경 - th:action

th:action

 

  • HTML form에서 action 에 값이 없으면 현재 URL에 데이터를 전송한다.
  • 상품 등록 폼의 URL과 실제 상품 등록을 처리하는 URL을 똑같이 맞추고 HTTP 메서드로 두 기능을 구분한다.
    • 상품 등록 폼: GET /basic/items/add
    • 상품 등록 처리: POST /basic/items/add
  • 이렇게 하면 하나의 URL로 등록 폼과, 등록 처리를 깔끔하게 처리할 수 있다.

 

th:if : 해당 조건이 참이면 실행

<h2 th:if="${param.status}" th:text="'저장 완료!'"></h2>
  • th:if : 해당 조건이 참이면 실행
  • ${param.status}: 타임리프에서 쿼리 파라미터를 편리하게 조회하는 기능

원래는 컨트롤러에서 모델에 직접 담고 값을 꺼내야 한다.

그런데 쿼리 파라미터는 자주 사용해서 타임리프에서 직접 지원한다.

 

 

 

참고

타임리프는 순수 HTML 파일을 웹 브라우저에서 열어도 내용을 확인할 수 있고, 서버를 통해 뷰 템플릿을 거치면
동적으로 변경된 결과를 확인할 수 있다. JSP를 생각해보면, JSP 파일은 웹 브라우저에서 그냥 열면 JSP 소스코
드와 HTML이 뒤죽박죽 되어서 정상적인 확인이 불가능하다. 오직 서버를 통해서 JSP를 열어야 한다.
이렇게 순수 HTML을 그대로 유지하면서 뷰 템플릿도 사용할 수 있는 타임리프의 특징을 

네츄럴 템플릿(natural templates)이라 한다.

 

 

 

 

'MVC' 카테고리의 다른 글

[MVC] Thymeleaf 기본 기능  (0) 2024.07.24
[MVC] PRG 패턴  (0) 2024.07.23
[MVC] HTTP 응답  (0) 2024.07.21
[MVC] HTTP 요청  (0) 2024.07.21
[MVC] 요청 매핑 방법  (1) 2024.07.19