django模板层(templates)

时间:2020-12-21 13:26:24

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 = name person_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>

# 注意这里调用字符串的方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数;你只能调用不需参数的方法

最终效果

django模板层(templates)

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 = 80
login_user = 66
return 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>

效果

django模板层(templates)

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>" % href
return mark_safe(result)  

views部分

from django.shortcuts import render

# Create your views here.

def views(request):
num = 5
return 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 render

def 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/路径下

django模板层(templates)

/authors/路径下

 django模板层(templates)

注意,包含 {{ block.super }}的html标签下,主模板下的h4有“”详细内容“”的字段有显示,被继承下来了

tips:

  • 如果模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况,模版继承都将无法工作。
  • base模版中设置越多的 {% block %} 标签越好。子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的内容,然后,只定义需要的那一个
  • 如果主模板{% block %} 标签下存在默认内容,此时如果你不想需要,或者需要改动,就可以使用{{ block.super }}
  • 为了提高可读性,可以给你的 {% endblock %} 标签一个 名字,如
{% block content %}
...
{% endblock content %}