django之模板template
Django模板中只需要记两种特殊符号：
{{ }}和 {% %}
{{ }}表示变量，在模板渲染的时候替换成值，{% %}表示逻辑相关的操作。
变量
{{ 变量名 }}
变量名由字母数字和下划线组成。
点（.）在模板语言中有特殊的含义，用来获取对象的相应属性值。
def template_test(request):
l = [11, 22, 33]
d = {"name": "jack"}
class Person(object):
def __init__(self, name, age):
self.name = name
self.age = age
def dream(self):
return "{} is dream...".format(self.name)
Jack = Person(name="Jack", age=34)
Ann = Person(name="Ann", age=25)
person_list = [Jack, Ann]
return render(request, "template_test.html", {"l": l, "d": d, "person_list": person_list})
模板中支持的写法：
{# 取l中的第一个参数 #}
{{ l.0 }}
{# 取字典中key的值 #}
{{ d.name }}
{# 取对象的name属性 #}
{{ person_list.0.name }}
{# .操作只能调用不带参数的方法 #}
{{ person_list.0.dream }}
注：当模板系统遇到一个（.）时，会按照如下的顺序去查询：
- 在字典中查询
- 属性或者方法
- 数字索引
Filters
过滤器，用来修改变量的显示结果。
语法： {{ value|filter_name:参数 }} ':'左右没有空格没有空格没有空格
内置filter
default
{{ value|default:"nothing"}}
如果value值没传的话就显示nothing
TEMPLATES的OPTIONS可以增加一个选项：string_if_invalid：'找不到'，可以替代default的的作用。
filesizeformat
将值格式化为一个 “人类可读的” 文件尺寸
{{ 123456789|filesizeformat }} # 输出117.7 MB
add
{{ first|add:second }}
数字相加，列表字符串拼接
lower大写
upper小写
title首字母大写
ljust 、rjust、center左对齐、右对齐、居中
length
{{ value|length }}
返回value的长度，如 value=['a', 'b', 'c', 'd']的话，就显示4.
slice
切片
{{value|slice:"2:-1"}}
first
取第一个元素
{{ value|first }}
last
取最后一个元素
{{ value|last }}
join
使用字符串拼接列表。同python的str.join(list)。
{{ value|join:" // " }}
truncatechars(truncatewords)
如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾。
参数：截断的字符数
{{ value|truncatechars:9}}
date
日期格式化
{{ value|date:"Y-m-d H:i:s"}}
可格式化输出的字符：点击查看。
也可以settings全局配置时间显示样式
USE_L10N = False DATETIME_FORMAT = 'Y-m-d H:i:s' # 对应datatime类型 DATE_FORMAT = 'Y-m-d' # 对应data类型 TIME_FORMAT = 'H:i:s' # 对应time类型
safe
为了安全起见防止xss攻击，django默认对变量以原内容显示，对其中包含的标签，js代码等不进行渲染执行，自动进行了转义。
单个变量如果需要取消转义，可以使用safe过滤器
value = "<a href='#'>点我</a>"
{{ value|safe}}
也可以：
from django.utils.safestring import mark_safe
mark_safe(变量)后传递给模板，也会取消转义
自定义filter
1.在app下创建一个名为tempplatetags的python包；
2.在包中创建py文件,文件名自定义（my_tags.py）;
3.在py文件中写：
from django import template
register = template.Library() # register也不能变
4.写函数+装饰器
@register.filter (name="add") # 可加name参数，不加默认为函数名
def add_xx(value, arg): # 最多有两个
return '{}-{}'.format(value, arg)
使用：
{% load my_tags %}
{{ 'python'|add_xx:'nb' }}
Tags标签
for
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% endfor %}
</ul>
for循环可用的一些参数：
| Variable | Description |
|---|---|
forloop.counter |
当前循环的索引值（从1开始） |
forloop.counter0 |
当前循环的索引值（从0开始） |
forloop.revcounter |
当前循环的倒序索引值（到1结束） |
forloop.revcounter0 |
当前循环的倒序索引值（到0结束） |
forloop.first |
当前循环是不是第一次循环（布尔值） |
forloop.last |
当前循环是不是最后一次循环（布尔值） |
forloop.parentloop |
本层循环的外层循环 |
for ... empty
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% empty %}
<li>空空如也</li>
{% endfor %}
</ul>
if,elif和else
{% if user_list %}
用户人数：{{ user_list|length }}
{% elif black_list %}
黑名单数：{{ black_list|length }}
{% else %}
没有用户
{% endif %}
{% if user_list|length > 5 %}
七座豪华SUV
{% else %}
黄包车
{% endif %}
if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断。
with
定义一个中间变量
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
{% with py as python %}
{{ python }}
{% endwith %}
csrf_token
这个标签用于跨站请求伪造保护。会生成一个隐藏的input标签，标记该文档。
在页面的form表单里面写上{% csrf_token %}
注释
{# ... #}
注意事项
- Django的模板语言不支持连续判断，即不支持以下写法：
{% if a > b > c %}
...
{% endif %}
- Django的模板语言中属性的优先级大于方法
def xx(request):
d = {"a": 1, "b": 2, "c": 3, "items": "100"}
return render(request, "xx.html", {"data": d})
如上，我们在使用render方法渲染一个页面的时候，传的字典d有一个key是items并且还有默认的 d.items() 方法，此时在模板语言中:
{{ data.items }}
默认会取d的items key的值。
母版和继承
母版
就是一个普通HTML提取多个页面的公共部分 定义block块
base.html模板如下定义：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
{% block page-css %}
{% endblock %}
</head>
<body>
{% block content %}
{% endblock %}
{% block js %}
{% endblock %}
</body>
</html>
继承：
-
重写block块 —— 写子页面独特的内容
{% extends 'base.html' %} {% block content %} <p>python</p> <p>是最好的语言</p> {% endblock %}
注意的点：
-
{% extends 'base.html' %} 写在第一行 前面不要有内容 有内容会显示
-
{% extends 'base.html' %} 'base.html' 加上引号 不然当做变量去查找
-
把要显示的内容写在block块中
-
通常会在母板中定义页面专用的CSS块和JS块，方便子页面替换。
组件
一小段HTML代码段 ——》 navbar.html
可以将常用的页面内容如导航条，页尾信息等组件保存在单独的文件中，然后在需要使用的地方按如下语法导入即可。
{% include 'navbar.html' %}
静态文件
在settings的静态文件别名发生改变，需要一个个进行修改，采用动态方式引用会避免这种情况。
方式一：
{% load static %}
<link rel="stylesheet" href="{% static '/plugins/bootstrap-3.3.7/css/bootstrap.css' %}">
<link rel="stylesheet" href="{% static '/css/home.css' %}">
某个文件多处被用到可以存为一个变量
{% load static %}
{% static "images/hi.jpg" as myphoto %}
<img src="{{ myphoto }}"></img>
方式二：
{% load static %}
<img src="{% get_static_prefix %}images/hi.jpg" alt="Hi!" />
{% load static %}
{% get_static_prefix as STATIC_PREFIX %}
<img src="{{ STATIC_PREFIX }}images/hi.jpg" alt="Hi!" />
<img src="{{ STATIC_PREFIX }}images/hi2.jpg" alt="Hello!" />
simpletag
和自定义filter类似，只不过接收更灵活的参数。
app下创建templatetags包，包中创建py文件写：
from django import template
register = template.Library() # register也不能变
@register.simple_tag
def join_str(*args, **kwargs):
return '{} - {} '.format('*'.join(args), '$'.join(kwargs.values()))
@register.simple_tag(name="plus")
def plus(a, b, c):
return "{} + {} + {}".format(a, b, c)
使用
{% load my_tags %}
{% join_str '1' '2' k1='3' k2='4' %}
{% plus "1" "2" "abc" %}
inclusion_tag
可以根据传递参数的不同动态的返回一个HTML代码段，组件只能加载一段静态的代码段。
示例：
templatetags/my_inclusion.py
from django import template
register = template.Library()
@register.inclusion_tag('result.html')
def show_results(n):
n = 1 if n < 1 else int(n)
data = ["第{}项".format(i) for i in range(1, n+1)]
return {"data": data}
templates/result.html
<ul>
{% for choice in data %}
<li>{{ choice }}</li>
{% endfor %}
</ul>
templates/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="x-ua-compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>inclusion_tag test</title>
</head>
<body>
{% load my_inclusion %}
{% show_results 10 %}
</body>
</html>
