目录
- 模板系统介绍
- django的模板语言组成
- 模板语言之变量
- 变量之深度查询（英文句点符.）
- 变量过滤器（filter）的使用
- 标签(tag)的使用
- 自定义filter和simple_tag
- 如何调用自定义filter和simple_tag
- 模板引入和继承
- 模板引入
- 模板继承
- 使用继承的注意事项：
- 模板继承的一些诀窍：
正文
模板系统介绍
模板系统的组成：HTML代码和逻辑控制代码
逻辑控制代码可以理解是django模板语言
django的模板语言组成
-
变量（使用双大括号来引用变量）：
- 标签（tag）的使用（使用大括号和百分比的组合来表示使用tag）
- 模板继承
模板语言之变量
语法：
|
1
|
{{var_name}} var_name 指变量名
|
使用模板语言之前：
先介绍template对象和Context对象
进入django的项目的交互环境
|
1
2
3
4
5
6
7
|
python manange.py shell
>>>
from
django.template import Context, Template
>>> t = Template(
'My name is {{ name }}.'
) #模板对象
>>> c = Context({
'name'
:
'xixi'
}) #上下文对象
>>> t.render(c)
'My name is xixi.'
|
同一模板，多个上下文，一旦有了模板对象，你就可以通过它渲染多个context，无论何时我们都可以像这样使用同一模板源渲染多个context，只进行 一次模板创建然后多次调用render()方法渲染会更为高效：
模板对象：可以理解文HTML文件，只不过包含了Django的模板语法
context对象：大多数的情况下，我们会将字典传给Context()，一旦初始化后，就可以使用标准的Python字典语法操作Context对象：
上下文对象如果是不合法的变量，模板系统会把他当做空字符串显示
|
1
2
3
|
>>> t = Template(
'Your name is {{ name }}'
) 变量名是name
>>> t.render(Context({
'var'
:
'hello'
})) #没有
var
这个变量名字
'Your name is '
|
变量之深度查询（英文句点符.）
上面只是通过 context 传递的简单参数值主要是字符串，然而，模板系统能够非常简洁地处理更加复杂的数据结构，例如list、dictionary和自定义的对象。
list索引
|
1
2
3
4
5
6
|
>>>
from
django.template import Context, Template
>>> names = [
"xixi"
,
"abc"
,
"123"
,
"hehe"
]
>>> t = Template(
"this is {{ name.0}}"
)
>>> c = Context({
"name"
:names})
>>> t.render(c)
'this is xixi'
|
如果不写 {{ name.0}} 后面的（.索引） 表示整个列表
字典
|
1
2
3
4
5
6
|
>>>
from
django.template import Template, Context
>>> person = {
'name'
:
"xixi"
,
"age"
: 21}
>>> t = Template(
"{{ person.name }} is {{ person.age }} years old."
)
>>> c = Context({
"person"
: person })
>>> t.render(c)
'xixi is 25 years old.'
|
自定义对象
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
>>>
from
django.template import Template, Context
>>> import datetime
>>> d = datetime.date(1996, 12,12 )
>>> d.year
1996
>>> d.month
12
>>> d.day
12
>>> t = Template(
'The month is {{ date.month }} and year is {{ date.year }}'
)
>>> c = Context({
'date'
: d})
>>> t.render(c)
'The month is 12 and year is 1996'
|
访问对象方法
|
1
2
3
4
5
|
>>> t = Template(
'{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}'
)
>>> t.render(Context({
'var'
:
'hello'
}))
'hello -- HELLO -- False'
>>> t.render(Context({
'var'
:
'123'
}))
'123 -- 123 -- True'
|
跟python操作差不多
变量过滤器（filter）的使用
语法格式
|
1
|
{{
var
|filter:param}}
|
管道符号后面的功能，比如{{ var|length }}，求变量长度的 length 就是一个过滤器。
常用的过滤器
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
1.add ： 给变量加上相应的值
2 addslashes : 给变量中的引号前加上斜线
3 capfirst : 首字母大写
4 cut ： 从字符串中移除指定的字符
5 date ： 格式化日期字符串
6
default
： 如果值是False,就替换成设置的默认值，否则就是用本来的值
7 default_if_none: 如果值是None，就替换成设置的默认值，否则就使用本来的值
|
标签(tag)的使用
语法格式
|
1
|
{% tags %}
|
{% if %} 的使用
{% if %} 和 {% endif %}要成对
{% if %}标签计算一个变量值，如果是“true”，即它存在、不为空并且不是false的boolean值,系统则会显示{% if %}和{% endif %}间的所有内容
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
{%
if
num >= 100 and 8 %}
{%
if
num > 200 %}
<p>num大于200</p>
{%
else
%}
<p>num大于100小于200</p>
{% endif %}
{% elif num < 100%}
<p>num小于100</p>
{%
else
%}
<p>num等于100</p>
{% endif %}
{%
if
%} 标签接受and，or或者not来测试多个变量值或者否定一个给定的变量
{%
if
%} 标签不允许同一标签里同时出现and和or，否则逻辑容易产生歧义，例如下面的标签是不合法的：
{%
if
obj1 and obj2 or obj3 %}
|
{% for %}的使用
{% for %} 和 {% endfor %}要成对
{% for %}标签允许你按顺序遍历一个序列中的各个元素,每次循环模板系统都会渲染{% for %}和{% endfor %}之间的所有内容
|
1
2
3
4
5
6
|
基本格式
<ul>
{%
for
obj
in
list %}
<li>{{ obj.name }}</li>
{% endfor %}
</ul>
|
在标签里添加reversed来反序循环列表：
|
1
2
3
|
{%
for
obj
in
list reversed %}
...
{% endfor %}
|
{% for %}标签可以嵌套：
|
1
2
3
4
5
6
7
8
|
{%
for
country
in
countries %}
<h1>{{ country.name }}</h1>
<ul>
{%
for
city
in
country.city_list %}
<li>{{ city }}</li>
{% endfor %}
</ul>
{% endfor %}
|
{% for %}不支持中断循环，也不支持continue语句
{% for %}关于循环其他用法
|
1
2
3
4
5
6
7
|
forloop.counter表示循环的次数，它从1开始计数，第一次循环设为1:
forloop.counter0 索引从 0 开始算
forloop.revcounter表示循环中剩下的items数量，第一次循环时设为items总数，最后一次设为1
forloop.revcounter0表示`items总数少一个，最后一次循环设置为0
forloop.first表示当第一次循环时值为True，在特别情况下很有用：
forloop.last表示当最后一次循环时值为True
forloop。parentioop表示在嵌套循环中表示父级循环的forloop
|
富有魔力的forloop变量只能在循环中得到，当模板解析器到达{% endfor %}时forloop就消失了
如果你的模板context已经包含一个叫forloop的变量，Django会用{% for %}标签替代它
Django会在for标签的块中覆盖你定义的forloop变量的值
在其他非循环的地方，你的forloop变量仍然可用
|
1
2
3
4
|
{%
for
item
in
todo_list %}
<p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}
表示循环的次数，它从1开始计数，第一次循环设为1:
|
{%csrf_token%}：csrf_token标签
用于生成csrf_token的标签，用于防治跨站攻击验证。注意如果你在view的index里用的是render_to_response方法，不会生效
{% url %}: 引用路由配置的地址
|
1
2
3
4
5
|
<form action=
"{% url "
路由别名
"%}"
>
<input type=
"text"
>
<input type=
"submit"
value=
"提交"
>
{%csrf_token%}
</form>
|
{% with %}:用更简单的变量名替代复杂的变量名
|
1
2
|
{% with total=fhjsaldfhjsdfhlasdfhljsdal %} {{ total }} {% endwith %}
基本很少起复杂变量名，一般起变量名都要特变形象
|
{% verbatim %}: 禁止render渲染
|
1
2
3
4
5
6
|
{% verbatim %}
{{ hello }}
{% endverbatim %
如果想要{{hello}}在网页正常显示出来，则用这个
|
{% load %}: 加载标签库
静态文件的引入方式用过
{% load staticfiles %}
后面引入其他的标签库在一一列出
自定义filter和simple_tag
我们自定义过滤器和简单的标签我们需要
- 在app中创建templatetags文件夹(文件夹名字必须的是这个)
- 创建任意 .py 文件，如：my_tags.py
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
#!/usr/bin/env python
#-*- coding:utf-8 -*-
from
django import template
from
django.utils.safestring import mark_safe
register = template.Library() #register的名字是固定的,不可改变
@register.filter
def filter_multi(x,y):
return
x*y
@register.simple_tag
def simple_tag_multi(x,y):
return
x*y
@register.simple_tag
def my_input(id,arg):
result =
"<input type='text' id='%s' class='%s' />"
%(id,arg)
return
mark_safe(result)
|
如何调用自定义filter和simple_tag
在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py ：{% load my_tags %}
在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
{% load my_tags %}
<!DOCTYPE html>
<html lang=
"en"
>
<head>
<meta charset=
"UTF-8"
>
<title>Title</title>
</head>
<body>
{{ num|filter_multi:2 }} #24 <br>
{{ num|filter_multi:
"[22,333,4444]"
}}<br>
<p>{% simple_tag_multi 2 5 %} 参数不限,但不能放在
if
for
语句中 </p>
{% simple_tag_multi num 5 %}
</body>
</html>
|
视图和路由的配置文件
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
#路由
from
django.conf.urls import url
from
django.contrib import admin
from
app01 import views
urlpatterns = [
url(r
'^admin/'
, admin.site.urls),
url(r
'^index/'
,views.index),
]
#视图
from
django.shortcuts import render,HttpResponse
# Create your views here.
def index(request):
num=12
return
render(request,
"index.html"
,locals())
|
注：filter可以用在if等语句后，simple_tag不可以
模板引入和继承
模板引入
{% include %}该标签允许在（模板中）包含其它的模板的内容。 标签的参数是所要包含的模板名称，可以是一个变量，也可以是用单/双引号硬编码的字符串。 每当在多个模板中出现相同的代码时，就应该考虑是否要使用 {% include %} 来减少重复。
引入方法
|
1
2
3
4
5
6
|
{% load staticfiles %}
HTML相关内容
{% include
'要引入的html文件名'
%}
|
模板继承
常见的 Web 开发问题： 在整个网站中，如何减少共用页面区域（比如站点导航）所引起的重复和冗余代码？
解决该问题的传统做法是使用 服务器端的 includes ，你可以在 HTML 页面中使用该指令将一个网页嵌入到另一个中。 事实上， Django 通过刚才讲述的 {% include %} 支持了这种方法。 但是用 Django 解决此类问题的首选方法是使用更加优雅的策略—— 模板继承 。
本质上来说，模板继承就是先构造一个基础框架模板，而后在其子模板中对它所包含站点公用部分和定义块进行重载。
如果子板不自定义块，默认会继承母板的所有内容（包括模板的css，js），如果子板要修改css或js文件，在相应地方加块，就可以了
例如：
简单写一个子板继承母板
定义母板文件base.html，定义子板要自定义的块
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<!DOCTYPE html>
<html lang=
"en"
>
<head>
<meta charset=
"UTF-8"
>
<title>Title</title>
</head>
<body>
<H1> HAHA </H1>
{% block content %}
<h2>子板自定义修改的内容</h2>
{% endblock %}
</body>
</html>
|
定义子板文件child.html
|
1
|
{% extends
"base.html"
%}
|
子板如果就这么一行代码，就会继承母板的所有内容，这{% extends "母板文件" %}必须写在最首行
如果要自定义修改块
|
1
2
3
4
|
{% extends
"base.html"
%}
{% block content %}
<h2 style=
"color: red"
>我是子板，修改了母板自定义块的内容</h2>
{% endblock %}
|
注：
母板
{% block 自定义块名%}
子板的块
{% block 母板中相应设置的块名 }
{% block %} 内容 {% endblock %}的标签也是成对出现
使用继承的注意事项：
- 创建 base.html 模板，在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。
- 为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。这些模板对base.html 进行拓展，并包含区域特定的风格与设计。
- 为每种类型的页面创建独立的模板，例如论坛页面或者图片库。 这些模板拓展相应的区域模板。
模板继承的一些诀窍：
-
- 如果在模板中使用 {% extends %} ，必须保证其为模板中的第一个模板标记。 否则，模板继承将不起作用。
- 一般来说，基础模板中的 {% block %} 标签越多越好。 记住，子模板不必定义父模板中所有的代码块，因此你可以用合理的缺省值对一些代码块进行填充，然后只对子模板所需的代码块进行（重）定义。 俗话说，钩子越多越好。
- 如果发觉自己在多个模板之间拷贝代码，你应该考虑将该代码段放置到父模板的某个 {% block %} 中。如果你需要访问父模板中的块的内容，使用 {{ block.super }}这个标签吧，这一个魔法变量将会表现出父模板中的内容。 如果只想在上级代码块基础上添加内容，而不是全部重载，该变量就显得非常有用了。
- 不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。也就是说，block 标签不仅挖了一个要填的坑，也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 {% block %} 标签，父模板将无从得知要使用哪个块的内容。