Django 模板

Django 的模板系统（Template System）是用于将业务逻辑（Python）与展示层（HTML）分离的核心组件，它允许开发者通过简单的标签和变量动态生成 HTML 页面。

在上一章节中我们使用 django.http.HttpResponse() 来输出 "Hello World！" ，该方式将数据与视图混合在一起，不符合 Django 的 MVT 思想。

本章节我们将为大家详细介绍 Django 模板的应用，模板是一个文本，用于分离文档的表现形式和内容。

功能	语法/示例	适用场景
变量渲染	`{{ variable }}`	动态显示数据
逻辑控制	`{% if %}` , `{% for %}`	条件/循环渲染
模板继承	`{% extends %}` , `{% block %}`	避免重复 HTML 结构
静态文件	`{% static 'path' %}`	加载 CSS/JS/图片
自定义过滤器	`@register.filter`	扩展模板功能

模板应用实例

我们接着上一章节的项目将在 HelloWorld 目录底下创建 templates 目录并建立 ez4code.html文件，整个目录结构如下：


HelloWorld/

|-- HelloWorld

|   |-- __init__.py

|   |-- __init__.pyc

|   |-- settings.py

|   |-- settings.pyc

|   |-- urls.py

|   |-- urls.pyc

|   |-- views.py

|   |-- views.pyc

|   |-- wsgi.py

|   `-- wsgi.pyc

|-- manage.py

`-- templates

    `-- ez4code.html

ez4code.html 文件代码如下：

示例代码

<h1>{{ hello }}</h1>

从模板中我们知道变量使用了双括号 {{ }} 。

接下来我们需要向 Django 说明模板文件的路径，打开 HelloWorld/HelloWorld/settings.py 文件，修改 TEMPLATES 中的 DIRS 为 [BASE_DIR / "templates"] ，如下所示:

示例代码

...TEMPLATES=[{'BACKEND':'django.template.backends.django.DjangoTemplates','DIRS':[BASE_DIR /"templates"],# 修改位置'APP_DIRS':True,'OPTIONS':{'context_processors':['django.template.context_processors.debug','django.template.context_processors.request','django.contrib.auth.context_processors.auth','django.contrib.messages.context_processors.messages',],},},]...

我们现在修改 views.py，增加一个新的对象，用于向模板提交数据：

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):context= {}context['hello']='Hello World!'returnrender(request,'ez4code.html',context)

可以看到，我们这里使用 render 来替代之前使用的 HttpResponse,render 还使用了一个字典 context 作为参数。

context 字典中元素的键值 hello 对应了模板中的变量 {{ hello }} 。

示例代码

fromdjango.contribimportadminfromdjango.urlsimportpathfrom.importviewsurlpatterns=[path('admin/',admin.site.urls),path('ez4code/',views.ez4code),]

接下来我们进入 HelloWorld 目录输入以下命令，启动服务器：


python3 manage.py runserver 0.0.0.0:8000

再次访问 http://127.0.0.1:8000/ez4code ，可以看到页面：

这样我们就完成了使用模板来输出数据，从而实现数据与视图分离。

接下来我们将具体介绍模板中常用的语法规则。

Django 模板标签

语法：

{% tag %}

控制模板逻辑，常用标签：

标签	用途
`{% for %}`	循环遍历列表/字典
`{% if %}`	条件判断
`{% extends %}`	继承基模板
`{% block %}`	定义可被子模板覆盖的内容块
`{% include %}`	嵌入其他模板片段
`{% url %}`	反向解析 URL（避免硬编码路径）
`{% csrf_token %}`	生成 CSRF 令牌（用于 POST 表单）

变量

模板语法：

view：｛"HTML变量名" : "views变量名"｝

HTML：｛｛变量名｝｝

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_name="易知码"returnrender(request,"ez4code.html",{"name":views_name})

templates 中的 ez4code.html ：

<p>{{ name }}</p>

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

列表

templates 中的 ez4code.html中，可以用 . 索引下标取出对应的元素。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_list=["易知码1","易知码2","易知码3"]returnrender(request,"ez4code.html",{"views_list": views_list})

示例代码

<p>{{ views_list }}</p># 取出整个列表<p>{{ views_list.0 }}</p># 取出列表的第一个元素

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

字典

templates 中的 ez4code.html中，可以用 .键取出对应的值。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_dict={"name":"易知码"}returnrender(request,"ez4code.html",{"views_dict": views_dict})

示例代码

<p>{{ views_dict }}</p><p>{{ views_dict.name }}</p>

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

过滤器

模板语法：


{{ 变量名 | 过滤器：可选参数 }}

模板过滤器可以在变量被显示前修改它，过滤器使用管道字符，如下所示：


{{ name|lower }}

{{ name }} 变量被过滤器 lower 处理后，文档大写转换文本为小写。

过滤管道可以被* 套接* ，既是说，一个过滤器管道的输出又可以作为下一个管道的输入：


{{ my_list|first|upper }}

以上实例将第一个元素并将其转化为大写。

有些过滤器有参数。过滤器的参数跟随冒号之后并且总是以双引号包含。例如：


{{ bio|truncatewords:"30" }}

这个将显示变量 bio 的前30个词。

其他过滤器：

addslashes : 添加反斜杠到任何反斜杠、单引号或者双引号前面。
date : 按指定的格式字符串参数格式化 date 或者 datetime 对象，实例：
```
{{ pub_date|date:"F j, Y" }}
```
length : 返回变量的长度。

default

default 为变量提供一个默认值。

如果 views 传的变量的布尔值是 false，则使用指定的默认值。

以下值为 false：


0  0.0  False  0j  ""  []  ()  set()  {}  None

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):name=0returnrender(request,"ez4code.html",{"name": name})

示例代码

{{ name|default:"易知码666" }}

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

length

返回对象的长度，适用于字符串和列表。

字典返回的是键值对的数量，集合返回的是去重后的长度。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):name="易知码"returnrender(request,"ez4code.html",{"name": name})

示例代码

{{ name|length}}

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

filesizeformat

以更易读的方式显示文件的大小（即'13 KB', '4.1 MB', '102 bytes'等）。

字典返回的是键值对的数量，集合返回的是去重后的长度。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):num=1024returnrender(request,"ez4code.html",{"num": num})

示例代码

{{ num|filesizeformat}}

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

date

根据给定格式对一个日期变量进行格式化。

格式 Y-m-d H:i:s 返回 年-月-日小时:分钟:秒 的格式时间。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):importdatetimenow=datetime.datetime.now()returnrender(request,"ez4code.html",{"time": now})

示例代码

{{ time|date:"Y-m-d" }}

再次访问 http://127.0.0.1:8000/ez4code，可以看到页面：

truncatechars

如果字符串包含的字符总个数多于指定的字符数量，那么会被截断掉后面的部分。

截断的字符串将以 ... 结尾。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_str="易知码"returnrender(request,"ez4code.html",{"views_str": views_str})

示例代码

{{ views_str|truncatechars:2}}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

safe

将字符串标记为安全，不需要转义。

要保证 views.py 传过来的数据绝对安全，才能用 safe。

和后端 views.py 的 mark_safe 效果相同。

Django 会自动对 views.py 传到HTML文件中的标签语法进行转义，令其语义失效。加 safe 过滤器是告诉 Django 该数据是安全的，不必对其进行转义，可以让该数据语义生效。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_str="<a href='https://www.ez4code.com/'>点击跳转</a>"returnrender(request,"ez4code.html",{"views_str": views_str})

示例代码

{{ views_str|safe }}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

if/else 标签

基本语法格式如下：


{% if condition %}

     ... display

{% endif %}

或者：


{% if condition1 %}

   ... display 1

{% elif condition2 %}

   ... display 2

{% else %}

   ... display 3

{% endif %}

根据条件判断是否输出。if/else 支持嵌套。

{% if %} 标签接受 and ， or 或者 not 关键字来对多个变量做判断，或者对变量取反（ not )，例如：


{% if athlete_list and coach_list %}

     athletes 和 coaches 变量都是可用的。

{% endif %}

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_num=88returnrender(request,"ez4code.html",{"num": views_num})

示例代码

{%ifnum>90andnum<=100%}优秀{%elifnum>60andnum<=90%}合格{%else%}一边玩去～{%endif%}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

for 标签

{% for %} 允许我们在一个序列上迭代。

与 Python 的 for 语句的情形类似，循环语法是 for X in Y ，Y 是要迭代的序列而 X 是在每一个特定的循环中使用的变量名称。

每一次循环中，模板系统会渲染在 {% for %} 和 {% endfor %} 之间的所有内容。

例如，给定一个运动员列表 athlete_list 变量，我们可以使用下面的代码来显示这个列表：


<ul>

{% for athlete in athlete_list %}

    <li>{{ athlete.name }}</li>

{% endfor %}

</ul>

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_list=["易知码","易知码1","易知码2","易知码3",]returnrender(request,"ez4code.html",{"views_list": views_list})

示例代码

{% for i in views_list %}{{ i }}{% endfor %}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

给标签增加一个 reversed 使得该列表被反向迭代：


{% for athlete in athlete_list reversed %}

...

{% endfor %}

示例代码

{% for i in views_list  reversed%}{{ i }}{% endfor %}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

遍历字典 : 可以直接用字典 .items 方法，用变量的解包分别获取键和值。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_dict={"name":"易知码","age":18}returnrender(request,"ez4code.html",{"views_dict": views_dict})

示例代码

{% for i,j in views_dict.items %}{{ i }}---{{ j }}{% endfor %}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

在 {% for %} 标签里可以通过 {{forloop}} 变量获取循环序号。

forloop.counter: 顺序获取循环序号，从 1 开始计算
forloop.counter0: 顺序获取循环序号，从 0 开始计算
forloop.revcounter: 倒序获取循环序号，结尾序号为 1
forloop.revcounter0: 倒序获取循环序号，结尾序号为 0
forloop.first（一般配合if标签使用）: 第一条数据返回 True，其他数据返回 False
forloop.last（一般配合if标签使用）: 最后一条数据返回 True，其他数据返回 False

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_list=["a","b","c","d","e"]returnrender(request,"ez4code.html",{"listvar": views_list})

示例代码

{% for i in listvar %}{{ forloop.counter }}{{ forloop.counter0 }}{{ forloop.revcounter }}{{ forloop.revcounter0 }}{{ forloop.first }}{{ forloop.last }}{% endfor %}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

{% empty %}

可选的 {% empty %} 从句：在循环为空的时候执行（即 in 后面的参数布尔值为 False ）。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):views_list=[]returnrender(request,"ez4code.html",{"listvar": views_list})

示例代码

{% for i in listvar %}{{ forloop.counter0 }}{% empty %}空空如也～{% endfor %}

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

可以嵌套使用 {% for %} 标签：


{% for athlete in athlete_list %}

    <h1>{{ athlete.name }}</h1>

    <ul>

    {% for sport in athlete.sports_played %}

        <li>{{ sport }}</li>

    {% endfor %}

    </ul>

{% endfor %}

注释标签

Django 注释使用 {# #}。


{# 这是一个注释 #}

include 标签

{% include %} 标签允许在模板中包含其它的模板的内容。

下面这个例子都包含了 nav.html 模板：


{% include "nav.html" %}

csrf_token

csrf_token 用于form表单中，作用是跨站请求伪造保护。

如果不用 {% csrf_token %} 标签，在用 form 表单时，要再次跳转页面会报 403 权限错误。

用了 {% csrf_token %} 标签，在 form 表单提交数据时，才会成功。

解析：

首先，向服务器发送请求，获取登录页面，此时中间件 csrf 会自动生成一个隐藏input标签，该标签里的 value 属性的值是一个随机的字符串，用户获取到登录页面的同时也获取到了这个隐藏的input标签。

然后，等用户需要用到form表单提交数据的时候，会携带这个 input 标签一起提交给中间件 csrf，原因是 form 表单提交数据时，会包括所有的 input 标签，中间件 csrf 接收到数据时，会判断，这个随机字符串是不是第一次它发给用户的那个，如果是，则数据提交成功，如果不是，则返回403权限错误。

自定义标签和过滤器

1、在应用目录下创建 templatetags 目录(与 templates 目录同级，目录名只能是 templatetags)。


HelloWorld/

|-- HelloWorld

|   |-- __init__.py

|   |-- __init__.pyc

|   |-- settings.py

...

|-- manage.py

`-- templatetags

`-- templates

2、在 templatetags 目录下创建任意 py 文件，如： my_tags.py 。

3、my_tags.py 文件代码如下：

from django import template



register = template.Library()   #register的名字是固定的,不可改变

修改 settings.py 文件的 TEMPLATES 选项配置，添加 libraries 配置：

示例代码

...TEMPLATES=[{'BACKEND':'django.template.backends.django.DjangoTemplates','DIRS':[BASE_DIR,"/templates",],'APP_DIRS':True,'OPTIONS':{'context_processors':['django.template.context_processors.debug','django.template.context_processors.request','django.contrib.auth.context_processors.auth','django.contrib.messages.context_processors.messages',],"libraries":{# 添加这边三行配置'my_tags':'templatetags.my_tags'# 添加这边三行配置}# 添加这边三行配置},},]...

4、利用装饰器 @register.filter 自定义过滤器。

注意： 装饰器的参数最多只能有 2 个。

@register.filter

def my_filter(v1, v2):

    return v1 * v2

5、利用装饰器 @register.simple_tag 自定义标签。

@register.simple_tag

def my_tag1(v1, v2, v3):

    return v1 * v2 * v3

6、在使用自定义标签和过滤器前，要在 html 文件 body 的最上方中导入该 py 文件。

{% load my_tags %}

7、在 HTML 中使用自定义过滤器。

{{ 11|my_filter:22 }}

8、在 HTML 中使用自定义标签。

{% my_tag1 11 22 33 %}

9、语义化标签

在该 py 文件中导入 mark_safe。


from django.utils.safestring import mark_safe

定义标签时，用上 mark_safe 方法，令标签语义化，相当于 jQuery 中的 html() 方法。

和前端HTML文件中的过滤器 safe 效果一样。

@register.simple_tag

def my_html(v1, v2):

    temp_html = "<input type='text' id='%s' class='%s' />" %(v1, v2)

    return mark_safe(temp_html)

在HTML中使用该自定义标签，在页面中动态创建标签。

{% my_html "zzz" "xxx" %}

配置静态文件

1、在项目根目录下创建 statics 目录。

2、在 settings 文件的最下方配置添加以下配置：


STATIC_URL = '/static/' # 别名 

STATICFILES_DIRS = [ 

    os.path.join(BASE_DIR, "statics"), 

]

3、在 statics 目录下创建 css 目录，js 目录，images 目录，plugins 目录，分别放 css文件，js文件，图片，插件。

4、把 bootstrap 框架放入插件目录 plugins。

5、在 HTML 文件的 head 标签中引入 bootstrap。

注意： 此时引用路径中的要用配置文件中的别名 static，而不是目录 statics。

<link rel="stylesheet" href="/static/plugins/bootstrap-3.3.7/dist/css/bootstrap.css">

在模板中使用需要加入 {% load static %} 代码，以下实例我们从静态目录中引入图片。

示例代码

fromdjango.shortcutsimportrenderdefez4code(request):name="易知码"returnrender(request,"ez4code.html",{"name": name})

示例代码

{% load static %}{{name}}<imgsrc="{% static 'images/ez4code-logo.png' %}"alt="ez4code-logo">

再访问访问 http://127.0.0.1:8000/ez4code，可以看到页面：

模板继承

模板可以用继承的方式来实现复用，减少冗余内容。

网页的头部和尾部内容一般都是一致的，我们就可以通过模板继承来实现复用。

父模板用于放置可重复利用的内容，子模板继承父模板的内容，并放置自己的内容。

父模板

标签 block...endblock: 父模板中的预留区域，该区域留给子模板填充差异性的内容，不同预留区域名字不能相同。

{% block 名称 %} 

预留给子模板的区域，可以设置设置默认内容

{% endblock 名称 %}

子模板

子模板使用标签 extends 继承父模板：

{% extends "父模板路径"%}

子模板如果没有设置父模板预留区域的内容，则使用在父模板设置的默认内容，当然也可以都不设置，就为空。

子模板设置父模板预留区域的内容：


{ % block 名称 % }

内容 

{% endblock 名称 %}

接下来我们先创建之前项目的 templates 目录中添加 base.html 文件，代码如下：

示例代码

<!DOCTYPEhtml><html><head><metacharset="utf-8"><title>易知码(ez4code.com)</title></head><body><h1>Hello World!</h1><p>易知码 Django 测试。</p>{% block mainbody %}<p>original</p>{% endblock %}</body></html>

以上代码中，名为 mainbody 的 block 标签是可以被继承者们替换掉的部分。

所有的 {% block %} 标签告诉模板引擎，子模板可以重载这些部分。

ez4code.html 中继承 base.html，并替换特定 block，ez4code.html 修改后的代码如下：

示例代码

{%extends"base.html"%}{%blockmainbody%}<p>继承了base.html文件</p>{%endblock%}

第一行代码说明 ez4code.html 继承了 base.html 文件。可以看到，这里相同名字的 block 标签用以替换 base.html 的相应 block。

重新访问地址 http://127.0.0.1:8000/ez4code，输出结果如下：

Django 模板 - DJANGO教程

Django 模板

模板应用实例

Django 模板标签

变量

列表

字典

过滤器

if/else 标签

for 标签

注释标签

include 标签

csrf_token

自定义标签和过滤器

配置静态文件

模板继承

父模板

子模板