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模板语法取值 只有一种操作方式 句点符 .

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

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

• 在字典中查询
• 属性或者方法
• 数字索引

<!--调用字符串对象的upper方法，注意不要加括号，函数和对象会自动加括号-->
<p>{{ msg.upper }}</p>

<!--取字典中k1对应的值-->
<p>{{ dic.k1 }}</p>

<!--取对象的name属性-->
<p>{{ obj.name }}</p>

<!--取列表的第2个元素,然后变成大写-->
<p>{{ li.1.upper }}</p>

<!--取列表的第3个元素，并取该元素的age属性-->
<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 }}

其他过滤器（了解）

模板语法之标签

逻辑相关

标签是为了在模板中完成一些特殊功能,语法为{% 标签名 %}，一些标签还需要搭配结束标签 {% 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 }}