후라이

[Thymeleaf] 타임리프 알아보기 본문

Spring

[Thymeleaf] 타임리프 알아보기

힐안 2024. 12. 27. 21:02

1. 타임리프 사용 선언

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

 

일반적인 html 뷰에 위와 같이 선언해주면 타임리프를 사용할 수 있습니다.

물론 start.spring.io로 generate할 때 타임리프 라이브러리를 다운 받거나 build.gradle에 추가해야합니다.

 

2. 속성 변경 - th:href

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

 

이렇게 th:xxx으로 선언하면 타임리프 뷰 템플릿을 거치게 되면서 원래 값을 th:xxx 값으로 변경하게 됩니다.  (만약 없다면 새로 생성)

HTML을 그대로 볼 때는 (정적으로) href 속성이 사용되고, 뷰 템플릿을 거치면 th:href의 값이 href로 대체되면서 동적으로 변경됩니다. (대부분의 HTML 속성을 th:xxx로 변경 가능)

 

3. 타임리프의 핵심

  • th:xxx이 붙은 부분은 서버 사이드에서 렌더링, 기존 것을 대체하게 됩니다. th:xxx이 없으면 기존 html의 xxx 속성이 그대로 사용됩니다!
  • HTML을 파일로 직접 열게 되면 th:xxx가 있어도 웹 브라우저는 단순히 정적인 html을 오픈한 것이므로 th 속성을 알지 못합니다. 즉, 무시하고 보여집니다.
  • HTML을 파일 보기를 유지하면서도 템플릿 기능을 하는 것이 타임리프입니다.

 

4. URL 링크 표현식

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

 

바로 "@"{...}가 핵심입니다.

타임리프는 URL 링크를 사용하는 경우 해당 문법으로 URL 링크를 표현하게 됩니다.

URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함하게 됩니다.

 

4-2 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 가 됩니다.

 

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

 

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

  • <span th:text=" 'Welcome to our application, ' +${user.name} + '!' ">
    위처럼 표현하면 ' ' 기호와 + 기호까지 굉장히 헷갈릴 수 있습니다.
  • <span th:text="|Welcome to our application, ${user.name}!|">
    이렇게 | | 리터럴 대체 문법을 사용하면, 더하기 없이 편리하게 사용 가능합니다.

 

6. 반복 출력 - th:each

 

반복은 th:each를 사용합니다.

아래 예시처럼 모델에 포함된 items 컬렉션 데이터가 item 변수에 하나씩 포함되고, 반복문 안에서 item 변수를 사용할 수 있습니다.

<tr th:each="item : ${items}">

 

컬렉션 수 만큼 <tr>..{/tr>이 하위 태그를 포함해서 생성합니다.

 

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

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

 

8. 내용 변경 - th:text

<td th:text="${item.price}">10000</td>
  • 내용의 값을 th:text의 값으로 변경합니다.
  • 10000이 디폴트 값인데 이 값이 item.price의 값으로 변경됩니다.

 

위 내용을 토대로 예시를 들면, 상품을 등록하는 폼에서 "등록하기"와 "등록취소" 버튼이 있다고 합시다.

내가 등록취소 버튼을 누르면 다른 뷰로 넘어가는 등의 동적인 활동이 일어나게 되겠죠?

그럴 때 해당 URL을 아래 예시처럼 표현할 수 있겠습니다.

<button class="w-100 btn btn-secondary btn-lg"
                onclick="location.href='items.html'"
                th:onclick="|location.href='@{/basic/items}'|"
                type="button">등록취소</button>