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>
'Spring' 카테고리의 다른 글
| @LoginUser 커스텀 어노테이션으로 로그인 사용자 정보 주입하기 (0) | 2025.01.14 |
|---|---|
| Spring security Config 설정 | 생각없이 따라하다가 deprecated 놓치잖아 (0) | 2025.01.08 |
| [SpringMVC] Spring MVC 파헤치기 | 응답편 (2) | 2024.12.26 |
| [SpringMVC] Spring MVC 파헤치기 | 요청편 (2) | 2024.12.26 |
| [Spring MVC] MVC 프레임워크 <2> (2) | 2024.12.19 |