Spring

[Spring] Thymeleaf(타임리프) 기초

동그리담 2024. 5. 8. 14:46

사용 선언

<html>
<!-- 로 변경-->
<html xlmns:th="http://www.thymeleaf.org">

 

속성 변경

타임리프는 html 속성을 th:xxx로 변경할 수 있다.

<a href="value1">
<!-- 를 변경-->
<a href="value1" th:href="value2">
<!-- 타임리프 뷰 템플릿을 거치면 value2	(안거치면 value1)-->

 

핵심

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

 

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

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

  • @{...} : 타임리프는 URL 링크를 사용하는 경우 @{...} 를 사용한다.
  • 이것을 URL 링크 표현식이라 한다. URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함한다.
                                                                                                           (↑현재는 안쓰이는 기능↑)

 

리터럴 대체 - |...| 

<button class="btn btn-primary float-end"
                    onclick="location.href='addForm.html'" type="button"
                    th:onclick="|location.href='@{/basic/items/add}'|">상품 등록
            </button>

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

  • 타임리프에서 문자와 표현식 등은 분리되어 있기 때문에 더해서 사용해야 한다
    • <span  th:text=" 'Welcome, ' + ${user.name} + '!' ">
  • 리터럴 대체를 사용하면 ' ' 와 + 없이 편하게 사용할 수 있다.
    • <span  th:text="|Welcome, ${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 객체를 사용할 수 있다.
    • for(String x : listArr) 과 비슷
  • 그리고 컬렉션 안의 객체 수만큼 <tr>  ... </tr> 이 하위태그를 포함해서 생성된다.

 

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

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

 

내용 변경 - th:text

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

 

URL 링크 표현식 2 - @{...{xxx}(xxx=${xxx})}

  • th:href="@{/basic/items/{itemId}(itemId=${item.id})}"
  • 경로 변수( {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}|}"
  • 리터럴 대체 문법을 활용해서 간단히 사용할 수도 있다.

쿼리 파라미터 사용

<!--  -->
<h2 th:if="${param.status}" th:text="저장 완료!"></h2>

 

 

* 참고 *

타임리프는 순수 HTML 파일을 웹 브라우저에서 열어도 내용을 확인할 수 있고, 서버를 통해 뷰 템플릿을 거치면 동적으로 변경된 결과를 확인할 수 있다.

JSP를 생각해보면, JSP 파일은 웹 브라우저에서 그냥 열면 JSP 소스코 드와 HTML이 뒤죽박죽 되어서 정상적인 확인이 불가능하다. 오직 서버를 통해서 JSP를 열어야 한다.

이렇게 순수 HTML을 그대로 유지하면서 뷰 템플릿도 사용할 수 있는 타임리프의 특징을 네츄럴 템플릿(natural templates)이라 한다.

타임리프 튜토리얼

https://www.thymeleaf.org/doc/tutorials/3.1/usingthymeleaf.html

 

 

HTMl => 뷰 템플릿 변경 사항 기록

 

속성 변경 - th:value

  • th:value="${item.id}"
  • 모델에 있는 item 정보를 획득하고 프로퍼티 접근법으로 출력한다. ( item.getId() )
  • value 속성을 th:value 속성으로 변경한다.

 

상품수정 링크

  • th:onclick="|location.href='@{/basic/items/{itemId}/edit(itemId=$ {item.id})}'|"

 

목록으로 링크

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

 

속성 변경 - th:action

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

 

취소

  • 취소시 상품 목록으로 이동한다.
  • th:onclick="|location.href='@{/basic/items}'|"

 

 

 

출처: https://tan-sog.tistory.com/90