使用app01子应用举例说明模板的使用。templates官方文档。
templates完整流程认知
第一步,在settings.py中注册app01子应用。
第二步,在app01目录下,新建templates和static目录,用于存放模板文件和资源文件。目录结构如下:
# user_list.html文件内容
<!DOCTYPE html>
{% load static %}
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<link rel="stylesheet" href="{% static 'plugins' %}">
</head>
<body>
<p>姓名是{{name}}, 性别是{{sex}}</p>
<p>身高是{{height}}, 体重是{{weight}}</p>
<h1>DTL模板引擎</h1>
<img src="/static/img/1.jpg" alt="">
</body>
</html>
第三步,在 app01/views.py中编写代码。注意render里的context字段值,和html文件中的变量名是对应关系。
# app01/views.py
from django.shortcuts import render # 返回html
def user_list(request):
# 按settings.py中app的注册顺序依次寻找templates目录
# data = {"name": "testyan", "sex": "M"}
height = 190
weight = 200
# return render(request, template_name='user_list.html', context=data)
# locals()用于获取本地变量
return render(request, template_name='user_list.html', context=locals())
# app01/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('index/', views.index),
path('user/list', views.user_list)
]
第四步,通过浏览器访问。
第二步中templates目录也可以建在根目录下,但要在settings.py中注册模板路径:
同样,static目录也可以建在根目录下,但要在settings.py中注册static资源路径:
django中的static下的静态资源,可以直接通过http://127.0.0.1:1992/static/xxxx拼接地址访问。但项目上线以后,关闭debug模式时,django默认是不提供静态文件的访问支持,项目部署的时候,我们会通过收集静态文件使用nginx这种web服务器来提供静态文件的访问支持。
代码缓存优化
上述的代码,我们可以进行缓存优化,即是将访问过的html保存到cache中,下次访问就不需要重新render渲染,而是直接从cache中读取。先在app01目录下新建.cache目录。
app01/views.py文件代码:
def user_list(request):
height = 190
weight = 200
# return render(request, template_name='user_list.html', context=locals())
if os.path.exists(BASE_DIR/'app01/.cache'/'user_list.html'):
print('走缓存文件')
with open(BASE_DIR / 'app01/.cache' / 'user_list.html', 'r') as f:
content = f.read()
else:
print('没走缓存文件')
# content = render_to_string('user_list.html', context=locals())
# 以下两行代码等同于上一行代码
template = get_template('user_list.html')
content = template.render(locals(), request)
with open(BASE_DIR/'app01/.cache'/'user_list.html', 'w') as f:
f.write(content)
return HttpResponse(content)
通过浏览器访问http://127.0.0.1:1992/app01/user/list时,只有第一次访问会打印“没走缓存文件”,后续访问都打印“走缓存文件”。
模板引擎语法
上述其实已经用到了变量的基础语法,格式为:{{变量}}
变量
在app01/urls.py中绑定路由不再截图示例。后续都不再强调这些步骤,默认实现。
以下是对列表、元组、集合、字典、对象等在模板引擎中的使用方式。
# app01/views.py
def index2(request):
list_var = ['v', 'vv', 'vvv']
tuple_var = ('ty', 100)
set_var = {'small', 'big'}
dict_var = {'ishappy': 'yes'}
obj_var = os
return render(request, template_name='user_list.html', context=locals())
<!DOCTYPE html>
{% load static %}
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<link rel="stylesheet" href="{% static 'plugins' %}">
</head>
<body>
<!-- <p>姓名是{{name}}, 性别是{{sex}}</p>-->
<!-- <p>身高是{{height}}, 体重是{{weight}}</p>-->
<h1>DTL模板引擎</h1>
<!-- <img src="/static/img/1.jpg" alt="">-->
<!-- <h1>html默认注释</h1>-->
{# DTL单行注释 #}
{% comment %}
多行注释
多行注释
{% endcomment %}
{# DTL中列表和元组,通过下标取值;而集合,通过pop取值,当集合都被清空后会报错 #}
<p>列表变量={{list_var}}, 列表单个元素={{list_var.1}}</p>
<p>元组变量={{tuple_var}}, 元组单个元素={{tuple_var.0}}</p>
<p>集合变量={{set_var}}, 集合单个元素={{set_var.pop}}, {{set_var.pop}}</p>
<p>字典变量={{dict_var}}, 字典单个元素={{dict_var.ishappy}}</p>
<p>对象变量={{obj_var}}, 对象中的方法调用返回的内容={{obj_var.getcwd}}</p>
</body>
</html>
标签
当数据过于复杂时,需要用到条件判断或循环功能。DTL中的 if 和 for 用法如下:
# views.py
#coding=utf-8
import os
from django.http import HttpResponse # 返回文字
from django.shortcuts import render # 返回html
def index2(request, idd):
id_var = idd
fruit_list = [
{"id": 1, "name": "苹果", "price": 10},
{"id": 2, "name": "香蕉", "price": 2.9},
{"id": 3, "name": "菠萝", "price": 9.9}
]
return render(request, template_name='user_list.html', context=locals())
<!DOCTYPE html>
{% load static %}
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<link rel="stylesheet" href="{% static 'plugins' %}">
</head>
<body>
{% if id_var == 0 %}
<p>id=0</p>
{% elif id_var <= 10 %}
<p>id是1-10以内</p>
{% elif id_var > 10 and id_var <= 100 %}
<p>id是11-100以内</p>
{% else %}
<p>id大于100</p>
{% endif %}
{% for fruit in fruit_list %}
<p>第{{forloop.counter}}行,{{fruit.name}}的价格是{{fruit.price}}</p>
{% endfor %}
</body>
</html>
for循环中提供了forloop对象:
属性 | 描述 |
forloop.counter | 显示循环的次数,从1开始 |
forloop.counter0 | 显示循环的次数,从0开始 |
forloop.revcounter0 | 倒数显示循环的次数,从0开始 |
forloop.revcounter | 倒数显示循环的次数,从1开始 |
forloop.first | 判断如果本次是循环的第一次,则结果为True |
forloop.last | 判断如果本次是循环的最后一次,则结果为True |
forloop.parentloop | 在多层嵌套循环中,指向当前循环的上级循环对象 |
过滤器
内置过滤器
全部内置过滤器请参考:过滤器官方文档,以下只列出一些比较常用的:
【过滤器用法都是{{str|default:"默认值”}} ,没有像python中default()这种用法】
内置过滤器 | 用法 | 示例 |
last | 获取列表/元组的最后一个成员 | {{list | last}} |
first | 获取列表/元组的第一个成员 | {{list|first}},也可以使用{list.0}} |
length | 获取数据的长度 | {{list | length}} |
default | 当变量没有值的情况下,系统输出默认值, | {{str|default:"默认值”}} |
safe | 标记一个字符串在输出前不需要进一步的 HTML 转义。当自动转义关闭时,该过滤器没有效果。 | {{htmlcontent| safe}} |
date | 日期时间格式转换 | {{ value| date:"Y-m-d H:i:s" }} |
cut | 从内容中截取掉同样字符的内容 | {{content | cut:"hello"}} |
filesizeformat | 把文件大小的数值转换成单位表示 | {{filesize | filesizeformat}) |
join | 用字符串连接一个列表,就像 Python 的 str.join(list) 一样。 | {{list| join:"-"}} |
random | 随机提取某个成员 | {list | random}} |
truncatechars | 按字符长度截取内容 | {{content | truncatechars:30}} |
# views.py中相关代码
def index2(request):
list_var = ['v', 'vv', 'vvv']
time = datetime.datetime.now()
url = '<a href="https://www.qq.com">链接</a>'
return render(request, template_name='user_list.html', context=locals())
# html文件相关代码
<p>列表中取随机元素={{list_var|random}}</p>
<p>当前时间={{time|date:'Y-m-d H:i:s'}}</p>
<p>不存在的字段名={{work|default:'no'}}</p>
<p>{{url|safe}}</p>
浏览器访问结果:
![]()
自定义过滤器
在上述for循环中,价格的小数位数是不一致的,我们可以通过自定义过滤器实现此功能。
前置操作:一定要把用到templates的app注册到settings.py的INSTALLED_APPS中。
根据官方文档,我们要在app01目录下,新建一个python包,名为 templatetags,注意这里新建的一定得是python包,而不能是普通的directory。
然后在templatetags目录下,新建一个python文件,这个文件名需要在html文件中加载。
num_format.py代码:
from django import template
register = template.Library()
# @register.filter("df")
def data_format(content, form=1):
return f'%.{form}f' % content
# 用装饰器或者用这个
register.filter("df", data_format)
html相关代码:
{% for fruit in fruit_list %}
<p>第{{forloop.counter}}行,{{fruit.name}}的价格是{{fruit.price|df:1}}</p>
{% endfor %}
重启!重启!
然后再通过浏览器访问时,就会发现price字段值都保留到小数点后一位,成功啦~~
模板分离和模板继承
模板分离
我们知道,不同路由页面一般都有些公共的内容,我们可以将公共的html代码提取出来,单独存入一个html,以便复用,这样叫做“模板分离”。
新建一个子应用sep,将应用注册模板,编写视图函数,配置路由等。将公共html内容写入public.html,而特定index1.html引用时,语法为
{% include 'public.html' %}
浏览器访问效果:
模板继承
继承语法:
{% extends 'base.html' %}
自定义块语法:
{% block 块名 %} xxxxx {% endblock %}
红框内容解析:在base.html中写入通用的html代码,特有的模块使用block来编写,然后在auth.html和account.html中对block具体实现。
绿框内容解析:在base.html中也可以写入block块的默认实现,auth.html中想去除“关闭浏览器”的功能,就重写block,中间为空或改为其它内容。