[250103] Django Template Language 란?

Django Template Language 란? 🅳🆃🅻

1. Django Template Language 정의

Django Template Language(DTL)는 Django에서 HTML을 동적으로 생성하기 위해 사용하는 템플릿 엔진입니다
DTL을 사용하면 백엔드에서 데이터를 전달받아 사용자에게 렌더링 할 수 있어요

2. 기본 문법

1. 변수 출력

템플릿에서 Python 변수를 출력하려면 `{{ variable_name }}` 을 사용해줍니다

<p>안녕하세요, {{ name }}님!</p>

전달된 변수 예제:

return render(request, 'index.html', {'name': 'Alice'})

결과:

<p>안녕하세요, Alice님!</p>

2. 필터 (Filters)

변수의 데이터를 변환하기 위해 필터를 사용합니다
구문: `{{ variable | filter_name }}`
여러 필터를 체인처럼 연결 가능해요

필터	설명	예제
`lower`	문자열을 소문자로 변환	`{{ name \| lower }}`
`upper`	문자열을 대문자로 변환	`{{ name \| upper }}`
`date`	날짜 포맷 지정	`{{ date \| date: "Y-m-d" }}`
`default`	값이 없을 경우 기본값 지정	`{{ age \| default: "미입력" }}`
`length`	길이 반환	`{{ items \| length }}`

<p>{{ name|upper }}</p>  <!-- Alice → ALICE -->
<p>{{ age|default:"나이 미입력" }}</p>  <!-- None → 나이 미입력 -->
<p>{{ items|length }}</p>  <!-- [1, 2, 3] → 3 -->

3. 태그 (Tags)

동적 로직을 템플릿에 추가하기 위해 사용합니다
구문: `{% tag_name %}`

조건문

{% if condition %}
    <p>조건이 참입니다.</p>
{% else %}
    <p>조건이 거짓입니다.</p>
{% endif %}

반복문

{% for item in items %}
    <li>{{ item }}</li>
{% empty %}
    <p>목록이 비어 있습니다.</p>
{% endfor %}

주요 태그

태그	설명	예제
`if`	조건문	`{% if user.is_authenticated %}`
`for`	반복문	`{% for item in items %}`
`block` / `extends`	템플릿 상속	`{% block content %}`
`include`	다른 템플릿 파일 포함	`{% include 'header.html' %}`
`csrf_token`	CSRF 토큰 추가	`<input type="hidden" name="csrfmiddlewaretoken" value="{{ csrf_token }}">`

4. 주석

주석은 템플릿에 렌더링되지 않아요

{# 이 부분은 주석 처리됩니다. #}

5. 템플릿 상속

템플릿 구조를 재사용하기 위한 기능합니다

기본 템플릿 (base.html)

<html>
<head>
    <title>{% block title %}기본 제목{% endblock %}</title>
</head>
<body>
    {% block content %}
    기본 내용
    {% endblock %}
</body>
</html>

확장 템플릿 (home.html)

{% extends "base.html" %}

{% block title %}홈 페이지{% endblock %}
{% block content %}
    <p>홈 페이지 내용입니다.</p>
{% endblock %}

6. Include (템플릿 분리)

다른 템플릿 파일을 현재 템플릿에 삽입합니다

header.html

<header>
    <h1>My Website</h1>
</header>

main.html

{% include "header.html" %}
<p>메인 페이지 내용</p>

7. URL 태그

`url` 태그를 사용해 URL Reverse 기능을 제공합니다

<a href="{% url 'home' %}">홈으로</a>

views.py

from django.urls import path

urlpatterns = [
    path('', views.home, name='home'),
]

8. Static 파일 사용

CSS, JS, 이미지 파일을 템플릿에 포함합니다
`load static` 태그를 사용하여 정적 파일 경로를 지정해줘요

{% load static %}
<link rel="stylesheet" href="{% static 'css/style.css' %}">
<img src="{% static 'images/logo.png' %}" alt="Logo">

9. Custom Filter/Tag 정의

템플릿에서 사용자 정의 필터나 태그를 추가할 수 있어요

custom_tags.py

from django import template

register = template.Library()

@register.filter
def multiply(value, arg):
    return value * arg

사용

<p>{{ 5|multiply:3 }}</p> <!-- 출력: 15 -->

10. 내장 템플릿 필터 및 태그

Django는 자주 사용하는 필터와 태그를 기본적으로 제공해줍니다

정리 🧹

DTL은 Django에서 동적 웹 페이지를 생성하는 핵심 도구이다~
데이터 바인딩, 조건/반복 로직, 템플릿 상속 등의 기능을 통해 유지보수성과 재사용성을 높여준다~
필터와 태그를 적절히 활용하면 더욱 강력하고 깔끔한 템플릿 코드를 작성할 수 있다~ 🚀

'Back End 📲 > Django ⛓️' 카테고리의 다른 글

[250110] ORM(Object-Relational Mapping)이란? (0)	2025.01.10
[250107] 트레일링 슬래시(Trailing Slash) 란? (0)	2025.01.07
[250106] HTML 폼(Form), 쿼리스트링(Query String), 그리고 Get (0)	2025.01.06
[241231] Class형 View와 함수형 View의 차이점 (0)	2024.12.31
[241230] MVC 패턴과 MTV 패턴 (2)	2024.12.30