김영한 님의 '스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술'을 듣고 적은 글입니다.
타임리프는 순수 HTML 파일을 웹 브라우저에서 열어도 내용을 확인할 수 있고, 서버를 통해 뷰 템플릿을 거치면 동적으로 변경된 결과를 확인할 수 있다. 이렇게 순수 HTML을 그대로 유지하면서 뷰 템플릿도 사용할 수 있는 타임리프의 특징을 네츄럴 템플릿이라고 한다.
<html xmlns:th="http://www.thymeleaf.org">
코드를 적어주면 된다.
예를 들어
<link href="../css/bootstrap.min.css"
th:href="@{/css/bootstrap.min.css}" rel="stylesheet">
위와 같이 적혀있다고 해보자. 타임리프 뷰 템플릿을 거치게 되면 원래 값으 th:xxx 값으로 변경한다. 만약 값이 없다면 새로 생성한다. HTML을 그대로 사용하게 되면 href 속성이 사용되고, 뷰 템플릿을 거치면 th:href의 값이 href로 대체되면서 동적으로 변경하여 사용할 수 있다.
핵심은 th:xxx가 붙은 부분은 서버사이드에서 렌더링되고, 기존 것을 대체한다. th:xxx이 없으면 기존 html의 xxx 속성이 그대로 사용된다.
HTML 파일을 직접 열었을 때, th:xxx가 있어도 웹 브라우저는 th: 속성을 알지 못하기에 무시한다.
타임리프는 URL 링크를 사용하는 경우 @{...}를 사용한다. URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함한다.
URL 링크 표현식을 사용하면 경로를 템플릿처럼 편리하게 사용할 수 있다.
해당 폼으로 이동하게 된다.
onclick = "location.href='addForm.html'";
타임리프에서는 문자와 표현식등은 분리되어 있기에 더해서 사용해야 한다.
<span th:text="'Welcome to our application, ' + ${user.name} + '!'">
아래와 같이 리터럴 대체 문법을 사용하면 + 기호 없이 편리하게 사용 가능하다.
<span th:text="|Welcome to our application, ${user.name}!|">
<tr th:each="item : ${items}">
반복은 th:each 를 사용한다. 이렇게 하면 모델에 포함된 items 컬렉션 데이터가 item변수에 하나씩 포함되고 반복문 안에서 사용할 수 있다. 자바의 for-each문을 사용하면 이해하기 쉬울 듯 하다.
모델에 포함된 값이나 타임리프 변수로 선언한 값을 조회할 수 있다. 프로퍼티 접근법을 사용한다.
<td th:text="${item.price}">10000</td>
내용의 값을 th:text 값으로 변경해준다. 위의 경우 10000을 ${item.price} 값으로 변경한다.
<h2 th:if="${param.status}" th:text="'저장 완료!'"></h2>
해당 조건이 참이면 실행한다.