1.基础部分
通过使用模板,就可以在URL中直接调用HTML,它还是松耦合的,灵活性强,而且更容易维护
而且可以将变量通过一定的方式嵌入到HTML中,最终渲染到页面,总的来说基于模板完成了数据与用户之间的交互
1.1模板HTML中的变量
用两个大括号括起来的文字(例如 {{ person_name }} )称为 变量 (variable)
url部分
urlpatterns = [path("third/",views.indexs) ]
views部分
import datetime def indexs(request):hel = "hello"lis_year = [18, 22, 32] # 列表dic = {"name": "luffy", "age": 18} # 字典date = datetime.datetime.now() # 日期对象class Person(object):def __init__(self, name):self.name = nameperson_1 = Person("zoro") # 自定义类对象person_2 = Person("sanzhi")person_3 = Person("robin")person = [person_1, person_2, person_3]return render(request, "index.html",{"hel":hel,"l": lis_year, "dic": dic, "ship_data": date, "person_list": person})
templates部分(名称index.html)
<!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><title>Title</title> </head> <body><h4>{{ hel }},</h4><h4>my name is {{ dic.name.upper }}.</h4> {# 句点符引用对象的方法 #}<h4>I'm {{ l.0 }}'s old.</h4> {# 视图对象索引0的值 #}<h4>and my born year is {{ ship_data|date:"y-m-d" }}.</h4>{% for name in person_list %} {# 遍历每一个元素 #}<h4> my partner is {{ name.name }}</h4> {# 类对象列表 #}{% endfor %} {# 必须要包含结束标志 #} </body> </html>
# 注意这里调用字符串的方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数;你只能调用不需参数的方法
最终效果
1.2模板语法
1.2.1 过滤器模板
default
default # 如果一个变量是false或为空,使用给定默认值,否则使用变量的值
{{value|deafult:"666"}}
length
length # 返回值的长度,如 value 是 ['a', 'b', 'c', 'd'],那么输出是 4
{{ value|length }}
filesizeformat
filesizeformat # 将值格式化为一个可读的文件尺寸,如 value 是 123456789,输出将会是 117.7 MB
{{ value|filesizeformat }}
date
date 如value=datetime.datetime.now()
{{ value|date:"Y-m-d" }}
slice
slice # 切片
{{ value|slice:"2:-1" }}
truncatechars
truncatechars # 截断,如果字符串字符多于指定的字符数量,那么会被截断。截断的字符串将以可翻译的省略号序列(“...”)结尾 参数:要截断的字符数
{{ value|truncatechars:9 }}
<p>截断字符:{{ content|truncatechars:20 }}</p>
<p>截断单词:{{ content|truncatewords:4 }}</p>
safe
safe # django会对模板中的语法自动转移,但是出于安全考虑,对于一些具有带链接跳转的功能标签则不会进行转义(如a标签)
{{value|safe}}
这里给演示一下safe的用法
url部分
from app01 import views urlpatterns = [path('admin/', admin.site.urls),path('views/',views.views)
views部分
这里一开始我以为value这块是写在模板中,但是不是的,他属于视图部分,只是在模板这里添加了{{ value|safe}}这一步
def views(request):lis = ['das','two','three','four'] value = "<a href='http://www.baidu.com'>click</a>"# 这里使用locals直接将上面的参数封装成了字典形式return render(request,'test.html',locals())# return render(request,'test.html',{"lis":lis,"value":value})
templates部分(test.html)
<!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><title>Title</title> </head> <body><h3>字典:{{ lis|slice:'1:-1' }}</h3>{{ value|safe }} </body> </html>
标签模板
for标签
遍历每一个元素
{% for person in person_list %}<p>{{ person.name }}</p>
{% endfor %}
# 可以利用{% for obj in list reversed %}反向完成循环
遍历一个字典
{% for key,val in dic.items %}<p>{{ key }}:{{ val }}</p>
{% endfor %}
# 这里循环序号可以通过{{forloop}}显示
forloop.counter The current iteration of the loop (1-indexed)
forloop.counter0 The current iteration of the loop (0-indexed)
forloop.revcounter The number of iterations from the end of the loop (1-indexed)
forloop.revcounter0 The number of iterations from the end of the loop (0-indexed)
forloop.first True if this is the first time through the loop
forloop.last True if this is the last time through the loop
forloop.last 是一个布尔值;在最后一次执行循环时被置为True。 一个常见的用法是在一系列的链接之间放置管道符(|)
另一个用途是为列表的每个单词加上逗号,把|换为逗号即可
{% for link in links%}{{link}}{% if not forloop.last%}|{% endif %}
{% endfor %}效果:
Link1 | Link2 | Link3 | Link4
for...empty
# 在给出的组是空的或者没有被找到时,可以有所操作。
{% for person in person_list %}<p>{{ person.name }}</p>{% empty %}<p>sorry,no person here</p>
{% endfor %}
if标签
# 对一个变量进行求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),对应的内容块会输出
{% if num > 100 or num < 0 %}<p>无效</p>
{% elif num > 80 and num < 100 %}<p>优秀</p>
{% else %}<p>凑合</p>
{% endif %}
with
# 用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用
{% with total=business.employees.count %}{{ total }} employee{{ total|pluralize }}
{% endwith %}
csrf_token
csrf_token # 该标签用于跨站请求伪造保护
相关例子示例:
views部分
def temps(request):lis = [10,20,30,50]dic = {"name":"luffy","age":18}lis = ['one','two','three','four']num = 80login_user = 66return render(request,'test.html',locals())
templates部分(test.html)
<!DOCTYPE html> <html lang="en"> <head><meta charset="UTF-8"><title>Title</title> </head> <body>{% for num in lis %}<h3> {{ num|add:100 }}</h3> {# 这里可以加减,带负号即可,没有乘除 #}{% endfor %}{% for k,v in dic.items %} {# 注意这里是dic.items #}<h3>{{ k }}:{{ v }}</h3>{% endfor %}{% for temp in lis %}<h3>{{ forloop.counter }}{{ temp }}</h3> {# 从1开始排 #}{% endfor %}{% if num >= 80 and num < 100 %} {# 注意空格,不然会飘红 #}<h3>优秀</h3>{% elif num >= 60 and num < 80 %}<h3>良好</h3>{% elif num < 60 %}<h3>不及格</h3>{% else %}<h2>出错啦</h2>{% endif %}<hr>{% if login_user %}<p>{{ login_user.name }}</p><a href="">注销</a><a href="">修改密码</a>{% else %}<a href="">登陆</a><a href="">注册</a>{% endif %}<hr><form action="" method="post">{% csrf_token %} {# 用于伪造保护,否则django会拒收报forbidden #}<input type="submit"></form> </body> </html>
效果
2. 自定义标签和过滤器
自定义标签和过滤器两者样式相同,这里一起演示
基本配置要求:
1.在settings中的INSTALLED_APPS配置当前app,不然django无法找到自定义的simple_tag.不过这里一般情况django都为我们配置好了
2.在app中创建templatetags模块(模块名只能是templatetags)
3.在该模块下创建任意名称的py文件(我用的是tags.py),它用于加载标签。注意里面还应该有一个__init__.py文件(用于告诉Python这是包含了一个Python代码的包)
tags.py文件
from django import template
from django.utils.safestring import mark_safe # 注意导入路径# 实例化一个对象,它属于模块级变量
register = template.Library()# 给模板增加一个乘法装饰器
@register.filter
def temp_multi(x1,x2):return x1*x2# 多个参数相乘
@register.simple_tag
def simple_temp_multi(x1,x2,x3):return x1*x2*x3# 自定义标签
@register.filter
def my_input(href):result = "<a href= %s >click</a>" % hrefreturn mark_safe(result)
views部分
from django.shortcuts import render# Create your views here.def views(request):num = 5return render(request,'tests.html',locals())
templates部分(tests.html)
这里面很重要的就是 {% load tags %} 这步,这一步就把tags.py模块加载进来的。{% load %} 标签检查 INSTALLED_APPS 中的设置,仅允许加载已安装的Django应用程序中的模板库。 这是一个安全特性;它可以让你在一台电脑上部署很多的模板库的代码,而又不用把它们暴露给每一个Django安装。
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body><p>自定义过滤器</p>{# 这里load的是templatetags下创建的文件名称,和导入模块类似 #} {% load tags %} {# 后面只能放一个参数,num相当x1,属于变量,2代表x2,属于默认参数 #}{{ num|temp_multi:2}}<br>{# 如果多个参数相乘,可以使用register.simple_tag装饰器,注意实参间的间距 #}{# 这个需要注意的是不能放在if for语句中使用 #}{% simple_temp_multi 10 8 9 %}<br>{# 自定义标签 #}<p>{{ "https://www.cnblogs.com/LearningOnline/p/9221956.html"|my_input }}</p></body>
</html>
3.模板继承(extend)
django中模板继承的主要意义在于降低代码的冗余度,这在后期项目中可是非常有意义的,可以大大缩减工作量
这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航
具体用法,先在templates创建一个主模板,一般命名base.html
<!DOCTYPE html> <html lang="en"> <head><title>书库</title> </head><body> <div><a href="http://127.0.0.1:8008/index/">首页</a></div> <div><a href="http://127.0.0.1:8008/authors/">作者</a></div> <div><a href="http://127.0.0.1:8008/articles/">文章管理</a></div><div id="content">{% block content %}<h4>详细内容</h4>{% endblock %} </div> </body> </html>
该base.html模板定义了一个可以用于两列排版页面的简单HTML骨架,“子模版”的工作是用它们的内容填充空的blocks。
block
标签定义了可以被子模版内容填充的block。 block
告诉模版引擎: 子模版可能会覆盖掉模版中的这些位置。
这里我写了三个模板,这三个模板都与主模板存在同一位置:
index.html
{% extends "base.html" %}{% block content %}<ul>{% for book in book_list %}<li><h3>{{ book }}</h3></li>{% endfor %}</ul>{% endblock content %}
authors.html
{% extends "base.html" %}{% block content %} {{ block.super }}{% for author in author_list %}<h2>{{ author }}</h2>{% endfor %} {% endblock content %}
articles.html
{% extends "base.html" %}{% block content %}{{ block.super }}<h3>增</h3><h3>删</h3><h3>改</h3><h3>查</h3> {% endblock content %}
#注意: extends
标签是这里的关键。它告诉模版引擎,这个模版“继承”了另一个模版。当模版系统处理这个模版时,首先,它将定位父模版。此外,父模板必须放在最顶端
我这里的views.py文件配置如下
from django.shortcuts import renderdef index(request):book_list = ['巨人的陨落','你一生的故事','灵魂只能独行']return render(request, 'index.html', locals())def articles(request):return render(request,'articles.html')def authors(request):author_list = ['肯福莱特','特德姜','周国平']return render(request,'authors.html',locals())
urls.py文件配置如下
from app01 import views urlpatterns = [path('admin/', admin.site.urls),path('index/',views.index),path('authors/', views.authors),path('articles/',views.articles), ]
运行效果,/index/路径下
/authors/路径下
注意,包含 {{ block.super }}的html标签下,主模板下的h4有“”详细内容“”的字段有显示,被继承下来了
tips:
- 如果模版中使用
{% extends %}
标签,它必须是模版中的第一个标签。其他的任何情况,模版继承都将无法工作。 - base模版中设置越多的
{% block %}
标签越好。子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的内容,然后,只定义需要的那一个 - 如果主模板
{% block %}
标签下存在默认内容,此时如果你不想需要,或者需要改动,就可以使用{{ block.super }} - 为了提高可读性,可以给你的
{% endblock %}
标签一个 名字,如
{% block content %}
...
{% endblock content %}