Django 5实用指南（五）模板系统
Django5的模板系统是其核心功能之一，允许开发者将动态数据嵌入到HTML模板中，并根据不同的业务需求渲染页面。Django模板系统基于 Django模板语言（DTL），它提供了一些强大的功能，如模板标签、过滤器、条件语句和循环等，帮助开发者灵活地渲染和控制页面内容。
本章将详细介绍 Django5 的模板语言、模板标签、过滤器及其自定义，帮助您深入理解如何在 Django 中使用模板系统。
5.1 Django5模板语言概述
Django 模板语言（DTL）是一种简单、易学的语言，能够有效地将动态内容注入到静态HTML中。Django模板的基本结构包括以下几个部分：
- 模板变量：用于显示动态数据。
- 模板标签：控制模板的逻辑（如条件语句、循环等）。
- 模板过滤器：用于修改变量的输出内容。
5.2 模板变量
模板变量用 {{ }} 包裹，通常来自于视图传递的数据。你可以在视图函数中传递数据到模板，然后使用模板变量将数据展示出来。
5.2.1 模板变量示例
假设你有一个 User 模型，并想显示用户的名字和邮箱。
视图函数：
from django.shortcuts import render
from .models import User
def user_profile(request, user_id):
user = User.objects.get(id=user_id)
return render(request, 'user_profile.html', {'user': user})模板：
<!DOCTYPE html>
<html>
<head>
<title>{{ user.username }}'s Profile</title>
</head>
<body>
<h1>Welcome, {{ user.username }}!</h1>
<p>Email: {{ user.email }}</p>
</body>
</html>在这个例子中，{{ user.username }} 和 {{ user.email }} 是模板变量，模板引擎会将它们替换为 user 对象中的 username 和 email 字段的值。
5.3 模板标签
模板标签用于实现更复杂的功能，如条件判断、循环等。标签使用 {% %} 包裹。常用的模板标签包括 if、for、block 等。
5.3.1 条件语句（if 标签）
if 标签用于根据条件执行不同的代码块。在模板中，if 标签用于判断条件是否成立，如果成立则执行相应的代码。
条件语句示例：
{% if user.is_authenticated %}
<p>Welcome back, {{ user.username }}!</p>
{% else %}
<p>Please log in to access your profile.</p>
{% endif %}在这个示例中，Django会检查 user.is_authenticated 是否为 True，如果是，则显示欢迎信息，否则提示用户登录。
5.3.2 循环语句（for 标签）
for 标签用于循环遍历一个序列（如列表、字典等）。在模板中，常用的 for 标签用于遍历列表或查询集。
循环语句示例：
<ul>
{% for post in posts %}
<li>{{ post.title }} - {{ post.created_at }}</li>
{% empty %}
<li>No posts available.</li>
{% endfor %}
</ul>在这个例子中，{% for post in posts %} 遍历 posts 列表中的每个 post 对象，显示文章的标题和创建时间。如果列表为空，则显示 No posts available。
5.3.3 引入模板（include 标签）
include 标签允许在一个模板中嵌入另一个模板，通常用于重复的页面结构，如头部、脚部等。
引入模板示例：
{% include 'header.html' %}
<h1>{{ title }}</h1>
{% include 'footer.html' %}在这个例子中，header.html 和 footer.html 是独立的模板文件，include 标签将它们嵌入到当前模板中。
5.4 模板过滤器
模板过滤器用于修改变量的显示方式。它们在模板变量后面用 | 分隔。例如，{{ value|lower }} 会将 value 变量转换为小写字母。
5.4.1 常见过滤器
date：格式化日期
<p>Published on: {{ post.created_at|date:"Y-m-d" }}</p>
default：如果变量为空，则使用默认值
<p>{{ user.bio|default:"This user has not updated their bio." }}</p>
length：返回一个列表或字符串的长度
<p>Number of posts: {{ posts|length }}</p>
lower：将字符串转换为小写
<p>{{ user.username|lower }}</p>
join：将列表元素连接成一个字符串
<p>{{ tags|join:", " }}</p>
5.4.2 自定义过滤器
Django 允许开发者创建自定义过滤器，以便在模板中使用。
自定义过滤器示例：
- 创建过滤器：
在 templatetags 目录下创建一个 custom_filters.py 文件：
from django import template
register = template.Library()
@register.filter
def add_suffix(value, suffix):
return f"{value}{suffix}"加载并使用过滤器：
在模板中使用自定义过滤器之前，首先需要加载该过滤器：
{% load custom_filters %}
<p>{{ user.username|add_suffix:"_profile" }}</p>在这个例子中，add_suffix 过滤器会将用户的用户名添加一个后缀 "_profile"。
5.5 模板继承与块（Block）
模板继承是 Django 模板系统的一个重要特性，它允许你创建一个基本的“框架”模板，并在子模板中插入特定内容。
5.5.1 基本模板（父模板）
父模板定义了网页的基本结构，如头部、导航栏、脚本等。使用 {% block %} 标签定义可以被子模板覆盖的部分。
父模板（base.html）：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{% block title %}My Website{% endblock %}</title>
</head>
<body>
<header>
<h1>Welcome to My Website</h1>
</header>
<nav>
<a href="/">Home</a> | <a href="/about">About</a>
</nav>
<main>
{% block content %}Default content{% endblock %}
</main>
<footer>
<p>© 2023 My Website</p>
</footer>
</body>
</html>5.5.2 子模板
子模板继承自父模板，并覆盖其中的块部分。
子模板（home.html）：
{% extends 'base.html' %}
{% block title %}Home - My Website{% endblock %}
{% block content %}
<h2>Welcome to the home page!</h2>
<p>This is where the content goes.</p>
{% endblock %}通过 {% extends %} 和 {% block %} 标签，子模板可以继承父模板的结构，并定制其内容。
5.6 模板的性能优化
在 Django 项目中，模板渲染的性能非常重要，尤其是在高流量的 Web 应用中。以下是一些优化模板性能的方法：
缓存模板：使用 Django 的模板缓存机制，减少重复渲染的开销。
{% load cache %}
{% cache 600 sidebar %}
<!-- 这里是需要缓存的内容 -->
{% endcache %}避免过多的循环和条件判断：尽量避免在模板中进行复杂的计算和大量的循环。
静态文件和媒体文件的优化：确保在模板中使用 static 标签来引用静态文件，并设置适当的缓存策略。
小结
本章深入介绍了 Django5 中的模板系统，包括模板变量、模板标签、过滤器的使用，以及如何自定义过滤器。我们还讲解了模板继承和块的概念，使得在大型项目中复用模板变得更加容易。通过有效的模板管理，Django5 提供了一个灵活、强大的系统来动态渲染和展示数据。