当前位置：首页 > article >正文

Django 5实用指南（五）模板系统

article 2026/4/12 2:37:30

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 Userdef 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：格式化日期

Published on: {{ post.created_at|date:"Y-m-d" }}

default：如果变量为空，则使用默认值

{{ user.bio|default:"This user has not updated their bio." }}

length：返回一个列表或字符串的长度

Number of posts: {{ posts|length }}

lower：将字符串转换为小写

{{ user.username|lower }}

join：将列表元素连接成一个字符串

{{ tags|join:", " }}

5.4.2 自定义过滤器

Django 允许开发者创建自定义过滤器，以便在模板中使用。

自定义过滤器示例：

创建过滤器：

在 templatetags 目录下创建一个 custom_filters.py 文件：

from django import templateregister = 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 提供了一个灵活、强大的系统来动态渲染和展示数据。