Django的templates（模板）
模板传值
模板过滤器
模板语法之标签
自定义过滤器和标签
模板的继承和导入
- 模板的导入之include标签
- 模板的继承/派生之extends标签，block标签

Django的templates（模板）

django的模板=HTML代码+模板语法

存放于templates目录下的html文件称之为模板文件

如果我们想要返回的html页面中的数据是动态的，那么必须在html页面中嵌入变量，这便用到了django的模板语法

变量

模板语法符号：{{ 变量名 }}，变量相关

1.1 深度查询：句点符的应用
1.2 过滤器

标签

模板语法符号：{% 标签名 %}，逻辑相关

自定义标签和过滤器

模板的导入和继承

模板传值

变量相关 {{ }}

如果html代码中的数据不是固定死的，而是动态变化的

则必须在html中嵌入变量，为此，模板语法提供了变量的概念，允许我们在html代码中嵌入变量

我们只需要在视图函数中用render方法为html文件中指定的变量赋值即可，具体用法如下

test.html
<p>{{ msg }}</p>
<p>{{ dic }}</p>
我们需要在视图函数中为模板test.html的变量名msg、dic、赋值,views.py内容如下
from django.shortcuts import render

def test(request):
  # 传给模板的变量值可以是任意python类型，如下
  msg='hello world'
    dic={'k1':1,'k2':2}
  return render(request,'test.html',{'msg':msg, 'dic':dic})   #指名道姓
  #return render(request,'test.html',locals())  # locals会将当前名称空间中所有的变量名全部传递给html页面
注意：

1、render函数的第三个参数包含了要传给模板的变量值，是一个字典类型

该字典中的key必须与模板文件中的变量名相对应，render函数会去templates目录下找到模板文件，然后根据字典中的key对应到模板文件中的变量名进行赋值操作，最后将赋值后的模板文件内容返回给浏览器

2、可以将render函数的第三个参数简写为locals(),如下

return render(request,'test.html',locals())

locals()会将函数test内定义的所有名字与值转换为字典中的k与v

句点符的使用

django模板语法取值只有一种操作方式句点符 .

句点符既可以引用容器类型的元素，也可以引用对象的方法

注意：当模板系统遇到一个（.）时，会按照如下的顺序去查询：

在字典中查询

属性或者方法

数字索引

<p>{{ msg.upper }}</p>


<p>{{ dic.k1 }}</p>


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


<p>{{ li.1.upper }}</p>


<p>{{ li.2.age }}</p>

模板过滤器

过滤器类似于python的内置函数，用来把视图传入的变量值加以修饰后再显示
{{ 变量名|过滤器名:传给过滤器的参数 }}
| 左边的会当做过滤器的第一个参数,过滤器名右边的会当做过滤器的第二个参数

常用内置过滤器

1 default

作用：如果一个变量值是False或者为空，使用default后指定的默认值，否则，使用变量本身的值

如果value= ’ ‘ ,则输出“nothing”
{{ value|default:"nothing" }}
2 length

作用：返回值的长度。它对字符串、列表、字典等容器类型都起作用

如果value是 ['a', 'b', 'c', 'd']，那么输出是4
{{ value|length }} 
3 filesizeformat

作用：将值的格式化为一个"人类可读的"文件尺寸(如13KB、4.1 MB、102bytes等等）

如果 value 是 12312312321，输出将会是 11.5 GB
{{ value|filesizeformat }} 
4 date

作用：将日期按照指定的格式输出，如果value=datetime.datetime.now(),

按照格式Y-m-d则输出2020-01-07
 {{ value|date:"Y-m-d" }}　　 
5 slice

作用：对输出的字符串进行切片操作，顾头不顾尾,

如果value=“santa“，则输出"sa"
{{ value|slice: '0:2' }}
6 truncatechars

作用：如果字符串字符多于指定的字符数量，那么会被截断。

截断的字符串将以可翻译的省略号序列（“...”）结尾

如果value=”hello world santa“，则输出"hello...",注意8个字符也包含末尾的3个点
{{ value|truncatechars:8 }}
7 truncatewords

作用：同truncatechars，但truncatewords是按照单词截断，注意末尾的3个点不算作单词

如果value=”hello world santa“，则输出"hello world ..."
 {{ value|truncatewords:2 }}
8 safe

作用：出于安全考虑，Django的模板会对HTML标签、JS等语法标签进行自动转义,例如

value="<script>alert(123)</script>"，模板变量{{ value }}会被渲染成<script>alert(123)</script>交给浏览器后会被解析成普通字符”<script>alert(123)</script>“，失去了js代码的语法意义，但如果我们就想让模板变量{{ value }}被渲染的结果又语法意义，那么就用到了过滤器safe

比如value='<a href="https://www.baidu.com">点我啊</a>'，在被safe过滤器处理后就成为了真正的超链接，不加safe过滤器则会当做普通字符显示’<a href="https://www.baidu.com">点我啊</a>‘
{{ value|safe }}

其他过滤器（了解）

过滤器	描述	示例
upper	以大写方式输出	{{ user.name \| upper }}
add	给value加上一个数值	{{ user.age \| add:”5” }}
addslashes	单引号加上转义号
capfirst	第一个字母大写	{{ ‘good’\| capfirst }} 返回”Good”
center	输出指定长度的字符串，把变量居中	{{ “abcd”\| center:”50” }}
cut	删除指定字符串	{{ “You are not a Englishman” \| cut:”not” }}
date	格式化日期
default	如果值不存在，则使用默认值代替	{{ value \| default:”(N/A)” }}
default_if_none	如果值为None, 则使用默认值代替
dictsort	按某字段排序，变量必须是一个dictionary	{% for moment in moments \| dictsort:”id” %}
dictsortreversed	按某字段倒序排序，变量必须是dictionary
divisibleby	判断是否可以被数字整除	`{{ 224 \| divisibleby:2 }} 返回 True`
escape	按HTML转义，比如将”<”转换为”&lt”
filesizeformat	增加数字的可读性，转换结果为13KB,89MB,3Bytes等	`{{ 1024 \| filesizeformat }} 返回 1.0KB`
first	返回列表的第1个元素，变量必须是一个列表
floatformat	转换为指定精度的小数，默认保留1位小数	{{ 3.1415926 \| floatformat:3 }} 返回 3.142 四舍五入
get_digit	从个位数开始截取指定位置的数字	{{ 123456 \| get_digit:’1’}}
join	用指定分隔符连接列表	{{ [‘abc’,’45’] \| join:’’ }} 返回 abc45
length	返回列表中元素的个数或字符串长度
length_is	检查列表，字符串长度是否符合指定的值	{{ ‘hello’\| length_is:’3’ }}
linebreaks	用或标签包裹变量	{{ “Hi\n\nDavid”\|linebreaks }} 返回HiDavid
linebreaksbr	用标签代替换行符
linenumbers	为变量中的每一行加上行号
ljust	输出指定长度的字符串，变量左对齐	{{‘ab’\|ljust:5}}返回 ‘ab ’
lower	字符串变小写
make_list	将字符串转换为列表
pluralize	根据数字确定是否输出英文复数符号
random	返回列表的随机一项
removetags	删除字符串中指定的HTML标记	{{value \| removetags: “h1 h2”}}
rjust	输出指定长度的字符串，变量右对齐
slice	切片操作，返回列表	{{[3,9,1] \| slice:’:2’}} 返回 [3,9] `{{ 'asdikfjhihgie' \| slice:':5' }} 返回 ‘asdik’`
slugify	在字符串中留下减号和下划线，其它符号删除，空格用减号替换	`{{ '5-2=3and5 2=3' \| slugify }} 返回 5-23and5-23`
stringformat	字符串格式化，语法同python
time	返回日期的时间部分
timesince	以“到现在为止过了多长时间”显示时间变量	结果可能为 45days, 3 hours
timeuntil	以“从现在开始到时间变量”还有多长时间显示时间变量
title	每个单词首字母大写
truncatewords	将字符串转换为省略表达方式	{{ 'This is a pen' \| truncatewords:2 }}返回``This is ...
truncatewords_html	同上，但保留其中的HTML标签	{{ 'This is a pen' \| truncatewords:2 }}返回``This is ...
urlencode	将字符串中的特殊字符转换为url兼容表达方式	{{ ‘http://www.aaa.com/foo?a=b&b=c’ \| urlencode}}
urlize	将变量字符串中的url由纯文本变为链接
wordcount	返回变量字符串中的单词数
yesno	将布尔变量转换为字符串yes, no 或maybe	{{ True \| yesno }}{{ False \| yesno }}{{ None \| yesno }} ``返回 ``yes``no ``maybe

模板语法之标签

逻辑相关

标签是为了在模板中完成一些特殊功能,语法为{% 标签名 %}，一些标签还需要搭配结束标签 {% endtag %}

常用标签之for标签

1 遍历每一个元素

{% for person in person_list %}
    <p>{{ person.name }}</p>
{% endfor %}

2 遍历一个字典

{% for key,val in dic.items %}
    <p>{{ key }}:{{ val }}</p>
{% endfor %}

4 循环序号可以通过{{ forloop }}显示　

forloop.counter            当前循环的索引值（从1开始）
forloop.counter0           当前循环的索引值（从0开始）
forloop.revcounter         当前循环的倒序索引值（从1开始）
forloop.revcounter0        当前循环的倒序索引值（从0开始）
forloop.first              当前循环是第一次循环则返回True，否则返回False
forloop.last               当前循环是最后一次循环则返回True，否则返回False
forloop.parentloop         本层循环的外层循环

5 for标签可以带有一个可选的{% empty %} 从句，在变量person_list为空或者没有被找到时，则执行empty子句

{% for person in person_list %}
    <p>{{ person.name }}</p>

{% empty %}
    <p>sorry,no person here</p>
{% endfor %}

常用标签之if标签

1、注意：
{% if 条件 %}条件为真时if的子句才会生效，条件也可以是一个变量，if会对变量进行求值，在变量值为空、或者视图没有为其传值的情况下均为False

2、具体语法
{% if num > 100 or num < 0 %}
    <p>无效</p>
{% elif num > 80 and num < 100 %}
    <p>优秀</p>
{% else %}
    <p>凑活吧</p>
{% endif %}

3、if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断。

常用标签之with标签

# with标签用来为一个复杂的变量名起别名,如果变量的值来自于数据库，在起别名后只需要使用别名即可，无需每次都向数据库发送请求来重新获取变量的值
{% with li.1.upper as v %}
    {{ v }}
{% endwith %}

自定义过滤器和标签

当内置的过滤器或标签无法满足我们需求时，我们可以自定义

1 在应用名下新建一个名字必须为templatetags的文件夹(文件夹名只能是templatetags)

2 在templatetags新建任意.py文件，如my_tags.py，在该文件中自定义过滤器或标签

from django.template import Library
register = Library()  # 注意变量名必须为register,不可改变

#1、自定义过滤器
@register.filter(name='my_filter')
def my_multi_filter(v1 ,v2): # 自定义的过滤器只能定义最多两个参数,针对{{ value1 | filter_multi:value2 }}，参数传递为v1=value1,v2=value2
    return  v1 * v2
@register.filter(name='my_filter')    # 相当于更改了函数名，使用时，使用新的函数名


#2、自定义标签
和自定义filter类似，区别：接收的参数更灵活，能接收万能参数
@register.simple_tag(name='my_tag')
def my_multi_tag(v1, v2, v3): # 自定义的标签可以定义多个参数
    return '%s?%s?%s?'%(v1, v2, v3)

#3、自定义inclusion_tag
@register.inclusion_tag('demo.html',name='my_inclu')
def index(n):
  li = []
  for i in range(n):
      li.append(i)
      #将列表传递给demo.html
      return {'li': li}

自定义过滤器或标签必须重新启动django方可生效

自定义过滤或标签的使用

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<!--必须先加载存有自定义过滤器和标签的文件-->
{% load my_tags %}
    
<!--salary的值为10，经过滤器my_multi_filter的处理结果为120-->
    自定义过滤器的使用
{{ salary|my_filter:12 }}
    
    自定义标签的使用
{% my_tag 1 2 3 'hello baby' %}
    
    自定义inclusion_tag的使用
{% my_inclu 5 %}

对比自定义标签与自定义过滤器

#1、自定义过滤器只能传两个参数，而自定义标签却可以传多个参数

#2、过滤器可以用于if判断，而标签不能
{% if salary|my_multi_filter:12 > 200 %}
    <p>优秀</p>
{% else %}
    <p>垃圾</p>
{% endif %}

模板的继承和导入

在实际开发中，模板文件彼此之间可能会有大量冗余代码，为此django提供了专门的语法来解决这个问题,主要围绕三种标签的使用：include标签、extends标签、block标签

模板的导入之include标签

作用：在一个模板文件中，引入/重用另外一个模板文件的内容，
{% include '模版名称m.html' %}

模板的继承/派生之extends标签，block标签

当某一个页面大部分区域都是公用的，那这个页面就可以作为模板页面

当别人继承这个页面后，要修改对应的区域

先在模板页面上通过block实现划定区域
{% block content %}   
  模板页面内容
{% endblock %}
子页面中先导入真个模板
{% extends '模板页面.html'%}
修改特定的区域  通过实现划定好的区域名称
{% block content %}
  子页面内容
{% endblock %}
通常情况下，模板页面应该起码有三块区域
{% block css %}   
  模板页面内容
{% endblock %}
{% block content %}   
  模板页面内容
{% endblock %}
{% block js %}    
  模板页面内容
{% endblock %}
模板的block块越多可扩展性越高

还支持子页面调用父页面对应区域的内容并且可以无限次调用
      {{ block.super }}