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 }}
其他过滤器（了解）
| 过滤器 | 描述 | 示例 |
|---|---|---|
| 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转义，比如将”<”转换为”<” | |
| 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 }}
自定义char
from django.db.models import Field class MyCharField(Field):
def __init__(self,max_length,*args,**kwargs):
self.max_length = max_length #拦截一个父类的方法 操作完之后 利用super调用父类的方法
super().__init__(max_length=max_length,*args,**kwargs) def db_type(self, connection):
return 'char(%s)'%self.max_length class Movie(models.Model):
textField = MyCharField(max_length=32)
特殊参数choices
1、定义字段时，指定参数choices
2、choices的值为元组套元组（事先定义好，一般在该表类中定义该字段之前定义）
3、每一个元组存放两个元素，形成一种对应关系
4、往数据库中存值时，该字段的值存为元组第一个元素即可
5、通过方式
对象.get_字段名_display()获取对应的元组第二个元素值，当没有对应关系时，返回的是它本身class Userinfo(models.Model):
username = models.CharField(max_length=32)
gender_choices = (
(1,'男'),
(2,'女'),
(3,'其他'),
)
gender = models.IntegerField(choices=gender_choices)
# 该字段还是存数字 并且可以匹配关系之外的数字
record_choices = (('checked', "已签到"),
('vacate', "请假"),
('late', "迟到"),
('noshow', "缺勤"),
('leave_early', "早退"),
)
record = models.CharField("上课纪录", choices=record_choices, default="checked", max_length=64) user_obj = models.Userinfo.objects.get(pk=1)
print(user_obj.username)
print(user_obj.gender)
# 针对choices参数字段 取值的时候 get_xxx_display()
print(user_obj.get_gender_display())
# 针对没有注释信息的数据 get_xxx_display()获取到的还是数字本身
user_obj = models.Userinfo.objects.get(pk=4)
print(user_obj.gender)
print(user_obj.get_gender_display())