Python Django框架学习05：Django 模板
在上一章节中我们使用 django.http.HttpResponse() 来输出 "Hello World！"。该方式将数据与视图混合在一起，不符合 Django 的 MVC 思想。
本章节我们将为大家详细介绍 Django 模板的应用，模板是一个文本，用于分离文档的表现形式和内容。
模板应用实例
我们接着上一章节的项目将在 HelloWorld 目录底下创建 templates 目录并建立 runoob.html文件，整个目录结构如下：
HelloWorld/
|-- HelloWorld
| |-- __init__.py
| |-- __init__.pyc
| |-- settings.py
| |-- settings.pyc
| |-- urls.py
| |-- urls.pyc
| |-- view.py
| |-- view.pyc
| |-- wsgi.py
| `-- wsgi.pyc
|-- manage.py
`-- templates
`-- runoob.html
runoob.html 文件代码如下：
HelloWorld/templates/runoob.html 文件代码：
{{ hello }}
从模板中我们知道变量使用了双括号。
接下来我们需要向Django说明模板文件的路径，修改HelloWorld/settings.py，修改 TEMPLATES 中的 DIRS 为 [BASE_DIR+"/templates",]，如下所示:
HelloWorld/HelloWorld/settings.py 文件代码：
...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',
],
},
},
]
...我们现在修改 view.py，增加一个新的对象，用于向模板提交数据：
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
context = {}
context['hello'] = 'Hello World!'
return render(request, 'runoob.html', context)HelloWorld/HelloWorld/urls.py 文件代码：
from django.urls import path
from . import view
urlpatterns = [
path('runoob/', view.runoob),
]可以看到，我们这里使用 render 来替代之前使用的 HttpResponse。render 还使用了一个字典 context 作为参数。
context 字典中元素的键值 hello 对应了模板中的变量 {{ hello }}。
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
这样我们就完成了使用模板来输出数据，从而实现数据与视图分离。
接下来我们将具体介绍模板中常用的语法规则。
Django 模板标签
变量
模板语法：
view：｛"HTML变量名" : "views变量名"｝ HTML：｛｛变量名｝｝
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_name = "菜鸟教程"
return render(request,"runoob.html", {"name":views_name})templates 中的 runoob.html ：
{{ name }}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
列表
templates 中的 runoob.html中，可以用 . 索引下标取出对应的元素。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_list = ["菜鸟教程1","菜鸟教程2","菜鸟教程3"]
return render(request, "runoob.html", {"views_list": views_list})HelloWorld/templates/runoob.html 文件代码：
{{ views_list }}
# 取出整个列表{{ views_list.0 }}
# 取出列表的第一个元素
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
字典
templates 中的 runoob.html中，可以用 .键 取出对应的值。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_dict = {"name":"菜鸟教程"}
return render(request, "runoob.html", {"views_dict": views_dict})HelloWorld/templates/runoob.html 文件代码：
{{ views_dict }}
{{ views_dict.name }}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
过滤器
模板语法：
{{ 变量名 | 过滤器：可选参数 }}
模板过滤器可以在变量被显示前修改它，过滤器使用管道字符，如下所示：
{{ 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
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
name =0
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代码：
{{ name|default:"菜鸟教程666" }}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
length
返回对象的长度，适用于字符串和列表。
字典返回的是键值对的数量，集合返回的是去重后的长度。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
name ="菜鸟教程"
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代码：
{{ name|length}}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
filesizeformat
以更易读的方式显示文件的大小（即'13 KB', '4.1 MB', '102 bytes'等）。
字典返回的是键值对的数量，集合返回的是去重后的长度。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
num=1024
return render(request, "runoob.html", {"num": num})HelloWorld/templates/runoob.html 文件代码：
{{ num|filesizeformat}}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
date
根据给定格式对一个日期变量进行格式化。
格式 Y-m-d H:i:s返回 年-月-日 小时:分钟:秒 的格式时间。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
import datetime
now =datetime.datetime.now()
return render(request, "runoob.html", {"time": now})HelloWorld/templates/runoob.html 文件代码：
{{ time|date:"Y-m-d" }}
再次访问 http://127.0.0.1:8000/runoob，可以看到页面：
truncatechars
如果字符串包含的字符总个数多于指定的字符数量，那么会被截断掉后面的部分。
截断的字符串将以 ... 结尾。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_str = "菜鸟教程"
return render(request, "runoob.html", {"views_str": views_str})HelloWorld/templates/runoob.html 文件代码：
{{ views_str|truncatechars:2}}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
safe
将字符串标记为安全，不需要转义。
要保证 views.py 传过来的数据绝对安全，才能用 safe。
和后端 views.py 的 mark_safe 效果相同。
Django 会自动对 views.py 传到HTML文件中的标签语法进行转义，令其语义失效。加 safe 过滤器是告诉 Django 该数据是安全的，不必对其进行转义，可以让该数据语义生效。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_str = "点击跳转"
return render(request, "runoob.html", {"views_str": views_str})HelloWorld/templates/runoob.html 文件代码：
{{ views_str|safe }}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
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 %}
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_num = 88
return render(request, "runoob.html", {"num": views_num})HelloWorld/templates/runoob.html 文件代码：
{% if num > 90 and num<= 100 %} 优秀
{% elif num > 60 and num <= 90 %} 合格
{% else %} 一边玩去～ {% endif %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
for 标签
{% for %} 允许我们在一个序列上迭代。
与 Python 的 for 语句的情形类似，循环语法是 for X in Y ，Y 是要迭代的序列而 X 是在每一个特定的循环中使用的变量名称。
每一次循环中，模板系统会渲染在 {% for %} 和 {% endfor %} 之间的所有内容。
例如，给定一个运动员列表 athlete_list 变量，我们可以使用下面的代码来显示这个列表：
{% for athlete in athlete_list %}
- {{ athlete.name }}
{% endfor %}
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_list = ["菜鸟教程","菜鸟教程1","菜鸟教程2","菜鸟教程3",]
return render(request, "runoob.html", {"views_list": views_list})HelloWorld/templates/runoob.html 文件代码：
{% for i in views_list %}
{{ i }}
{% endfor %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
给标签增加一个 reversed 使得该列表被反向迭代：
{% for athlete in athlete_list reversed %}
...
{% endfor %}
HelloWorld/templates/runoob.html 文件代码：
{% for i in views_list reversed%} {{ i }} {% endfor %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
遍历字典: 可以直接用字典 .items 方法，用变量的解包分别获取键和值。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_dict = {"name":"菜鸟教程","age":18}
return render(request, "runoob.html", {"views_dict": views_dict})HelloWorld/templates/runoob.html 文件代码：
{% for i,j in views_dict.items %}
{{ i }}---{{ j }}
{% endfor %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
在 {% for %} 标签里可以通过 {{forloop}} 变量获取循环序号。
- forloop.counter: 顺序获取循环序号，从 1 开始计算
- forloop.counter0: 顺序获取循环序号，从 0 开始计算
- forloop.revcounter: 倒叙获取循环序号，结尾序号为 1
- forloop.revcounter0: 倒叙获取循环序号，结尾序号为 0
- forloop.first（一般配合if标签使用）: 第一条数据返回 True，其他数据返回 False
- forloop.last（一般配合if标签使用）: 最后一条数据返回 True，其他数据返回 False
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_list = ["a", "b", "c", "d", "e"]
return render(request, "runoob.html", {"listvar": views_list})HelloWorld/templates/runoob.html 文件代码：
{% for i in listvar %}
{{ forloop.counter }}
{{ forloop.counter0 }}
{{ forloop.revcounter }}
{{ forloop.revcounter0 }}
{{ forloop.first }}
{{ forloop.last }}
{% endfor %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
{% empty %}
可选的 {% empty %} 从句：在循环为空的时候执行（即 in 后面的参数布尔值为 False ）。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
views_list = []
return render(request, "runoob.html", {"listvar": views_list})HelloWorld/templates/runoob.html 文件代码：
{% for i in listvar %}
{{ forloop.counter0 }}
{% empty %}
空空如也～
{% endfor %}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
可以嵌套使用 {% for %} 标签：
{% for athlete in athlete_list %}{{ athlete.name }}
{% for sport in athlete.sports_played %}
{% endfor %}- {{ sport }}
{% endfor %}
ifequal/ifnotequal 标签
{% ifequal %} 标签比较两个值，当他们相等时，显示在 {% ifequal %} 和 {% endifequal %} 之中所有的值。
下面的例子比较两个模板变量 user 和 currentuser :
{% ifequal user currentuser %}
Welcome!
{% endifequal %}
和 {% if %} 类似， {% ifequal %} 支持可选的 {% else%} 标签：8
{% ifequal section 'sitenews' %}
Site News
{% else %}
No News Here
{% endifequal %}
注释标签
Django 注释使用 {# #}。
{# 这是一个注释 #}
include 标签
{% include %} 标签允许在模板中包含其它的模板的内容。
下面这个例子都包含了 nav.html 模板：
{% include "nav.html" %}
模板继承
模板可以用继承的方式来实现复用。
接下来我们先创建之前项目的 templates 目录中添加 base.html 文件，代码如下：
HelloWorld/templates/base.html 文件代码：
菜鸟教程(runoob.com)
Hello World!
菜鸟教程 Django 测试。
{% block mainbody %}
original
{% endblock %}
以上代码中，名为 mainbody 的 block 标签是可以被继承者们替换掉的部分。
所有的 {% block %} 标签告诉模板引擎，子模板可以重载这些部分。
runoob.html 中继承 base.html，并替换特定 block，runoob.html 修改后的代码如下：
HelloWorld/templates/runoob.html 文件代码：
{%extends "base.html" %}
{% block mainbody %}
继承了 base.html 文件
{% endblock %}
第一行代码说明 runoob.html 继承了 base.html 文件。可以看到，这里相同名字的 block 标签用以替换 base.html 的相应 block。
重新访问地址 http://127.0.0.1:8000/runoob，输出结果如下：
csrf_token
csrf_token 用于form表单中，作用是跨站请求伪造保护。
如果不用｛% csrf_token %｝标签，在用 form 表单时，要再次跳转页面会报403权限错误。
用了｛% csrf_token %｝标签，在 form 表单提交数据时，才会成功。
解析：
首先，向浏览器发送请求，获取登录页面，此时中间件 csrf 会自动生成一个隐藏input标签，该标签里的 value 属性的值是一个随机的字符串，用户获取到登录页面的同时也获取到了这个隐藏的input标签。
然后，等用户需要用到form表单提交数据的时候，会携带这个 input 标签一起提交给中间件 csrf，原因是 form 表单提交数据时，会包括所有的 input 标签，中间件 csrf 接收到数据时，会判断，这个随机字符串是不是第一次它发给用户的那个，如果是，则数据提交成功，如果不是，则返回403权限错误。
自定义标签和过滤器
1、在 app 目录下创建 templatetags 目录(目录名只能是 templatetags)。
2、在 templatetags 目录下创建任意 py 文件，如：my_tags.py。
3、在该 py 文件下：
from django import template register = template.Library() #register的名字是固定的,不可改变
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 = "" %(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, "HelloWorld/statics"),
]
3、在 statics 目录下创建 css 目录，js 目录，images 目录，plugins 目录， 分别放 css文件，js文件，图片，插件。
4、把 bootstrap 框架放入插件目录 plugins。
5、在 HTML 文件的 head 标签中引入 bootstrap。
注意：此时引用路径中的要用配置文件中的别名 static，而不是目录 statics。
在模板中使用需要加入 {% load static %} 代码，以下实例我们从静态目录中引入图片。
HelloWorld/HelloWorld/view.py 文件代码：
from django.shortcuts import render
def runoob(request):
name ="菜鸟教程"
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代码：
{% load static %} {{name}}
再访问访问 http://127.0.0.1:8000/runoob，可以看到页面：
更多内容，可关注作者的微信公众号：胖哥真不错。
