타임리프를 사용하려면 사용할 스프링 프로젝트에 관련 라이브러리 의존성을 설치해야 한다.
dependencies {
//타임리프 의존성 설치
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
}
타임리프 사용 시 이점
타임리프는 순수 HTML 파일을 웹 브라우저에서 열어도 내용을 확인할 수 있고, 서버를 통해 뷰 템플릿을 거치면 동적으로 변경된 결과를 확인할 수 있다. JSP를 생각해보면, JSP 파일은 웹 브라우저에서 그냥 열면 JSP 소스코드와 HTML이 뒤죽박죽 되어서 정상적인 확인이 불가능하다. 오직 서버를 통해서 JSP를 열어야 한다.
타임리프 사용 선언 - <html xmlns : >
- 타임리프를 사용하려면 html 태그의 xmlns 속성을 사용하여 타임리프 url을 입력한다.
<html xmlns:th="http://www.thymeleaf.org">
타임리프 핵심
- 타임리프에서 ' th : xxx '가 붙은 부분은 서버사이드렌더링(SSR)이 되고 기존의 것(정적 태그)을 대체한다.
- ' th : xxx '가 없으면 기존의 xxx속성이 그대로 사용된다. => 뷰를 만드는 클라이언트 쪽의 수정을 건드리지 않아도 되는 장점이 있음.
- 따라서, HTML을 파일로 직접 열었을 때, ' th : xxx '가 있어도 웹 브라우저는 th : 의 속성을 알지 못하므로 무시한다.
=> HTML을 파일보기를 유지하면서 템플릿 기능도 할 수 있는 장점이 있다. (== natural templates (타임리프의 특징))
타임리프 기능
URL 링크 표현식 - @{...}
ex. th:href="@{/css/bootstrap.min.css}"
th:href="@{/basic/items/{itemId}(itemId=${item.id})}"
- @{...} : 타임리프는 URL 링크를 사용하는 경우 @{...} 를 사용한다.
- URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함한다.
- 이로 인해 서블릿 컨텍스트의 경로를 명시하지 않아 프로젝트의 디렉토리 구조를 변경할 때, 서블릿 컨텍스트를 수동으로 수정할 필요가 없는 이점이 있다.
- 경로 변수( {itemId} ) 뿐만 아니라 쿼리 파라미터도 생성한다.
- 예) th:href="@{/basic/items/{itemId}(itemId=${item.id}, query='test')}"
- 생성 링크: http://localhost:8080/basic/items/1?query=test
리터럴 대체 - |...|
- 타임리프에서 문자와 표현식 등은 분리되어 있기 때문에 더해서 사용해야 한다.
- 예) <span th:text="'Welcome to our application, ' + ${user.name} + '!'">
- 리터럴 대체 문법을 사용하면, 더하기 없이 편리하게 사용할 수 있다.
- 예) <span th:text="|Welcome to our application, ${user.name}!|">
- 이처럼, 리터럴 대체 문법을 사용하면 복잡한 문자와 표현식을 좀 더 간단히 표현함으로써 코드 가독성이 좋아진다.
반복 출력 - th : each
ex. <tr th:each="item : ${items}">
- 위의 예로 설명하자면, 모델에 포함된 items 컬렉션 데이터가 item 변수에 하나씩 포함되고, 반복문 안에서 item 변수를 사용할 수 있다.
- 컬렉션의 수(items의 수)만큼 <tr>이 하위 태그를 포함하여 생성된다.
- 즉, 테플릿 내에서 반복문처럼 사용되어 반복되는 요소를 쉽게 처리할 수 있다.
변수 표현식 - ${...}
타임리프에서 변수를 사용할 때 쓰는 것
ex. <td th:text="${item.price}">10000</td>
- 변수 표현식에는 스프링 EL이라는 스프링이 제공하는 표현식을 사용할 수 있다.
예) user 객체의 username을 출력할 경우, 타임리프에서 다음과 같이 값을 호출할 수 있다.- user.username => user의 username을 프로퍼티로 접근함.
- user[ ' username ' ] => 위와 동일.
- user.getUsername() => user의 get메서드를 직접 호출.
- 모델에 포함된 값이나, 타임리프 변수로 선언한 값을 조회할 수 있다.
- 프로퍼티 접근법을 사용한다. ( item.getPrice()의 값이 ${item.price}에 매핑된다.)
내용 변경 - th : text
HTML의 콘텐츠(content)에 데이터를 출력 할 때 쓰이는 기능
<td th:text="${item.price}">10000</td>
- 내용의 값을 th:text 의 값으로 변경한다. (10000을 ${item.price} 값으로 변경)
- 예를 들어, ${item.price} 값에 25000이 저장되어 있다면 템플릿 호출 시, 10000이 아닌 25000으로 출력된다.
조건문 - th : if
<h4 th:if="${param.status}" th:text="'상품이 등록되었습니다.'"></h4>
- 쿼리파라미터 'status' 값이 true일 때 " '상품이 등록되었습니다.' "를 출력한다.
- if 이후의 조건이 참이면 해당 요소가 실행된다.
- ${ }안에 표현식을 작성하여 조건을 설정하면 된다.
- ${ role eq 'ADMIN' } - role 변수가 'ADMIN'일 때
- ${count != 0} - count가 0이 아닐 때
'Spring > Thymeleaf' 카테고리의 다른 글
| Thymeleaf 주요 기능 4 (1) | 2024.01.10 |
|---|---|
| Thymeleaf 스프링 통합 (0) | 2024.01.08 |
| Thymeleaf 주요 기능 2 (0) | 2024.01.05 |
| Themeleaf 개요 (0) | 2024.01.02 |
