1、模板系统的介绍
你可能已经注意到我们在例子视图中返回文本的方式有点特别。 也就是说,HTML被直接硬编码在 Python代码之中。
1 def current_datetime(request):
2 now = datetime.datetime.now()
3 html = "<html><body>It is now %s.</body></html>" % now
4 return HttpResponse(html)
尽管这种技术便于解释视图是如何工作的,但直接将HTML硬编码到你的视图里却并不是一个好主意。 让我们来看一下为什么:
-
对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。 站点设计的修改往往比底层 Python 代码的修改要频繁得多,因此如果可以在不进行 Python 代码修改的情况下变更设计,那将会方便得多。
-
Python 代码编写和 HTML 设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
-
程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。
基于这些原因,将页面的设计和Python的代码分离开会更干净简洁更容易维护。 我们可以使用 Django的 模板系统 (Template System)来实现这种模式,这就是本章要具体讨论的问题。
------------------------------------------------------------------模板语法------------------------------------------------------------------
2、模板的组成
组成:HTML代码+逻辑控制代码
3、逻辑控制代码的组成
3.1 变量(使用双大括号来引用变量):
1 语法格式: {{var_name}}
------Template和Context对象
1 >>> python manange.py shell (进入该django项目的环境)
2 >>> from django.template import Context, Template
3 >>> t = Template('My name is {{ name }}.')
4 >>> c = Context({'name': 'Stephane'})
5 >>> t.render(c)
6 'My name is Stephane.'
7
8
9 # 同一模板,多个上下文,一旦有了模板对象,你就可以通过它渲染多个context,无论何时我们都可以
10 # 像这样使用同一模板源渲染多个context,只进行 一次模板创建然后多次调用render()方法渲染会
11 # 更为高效:
12 # Low
13 for name in ('John', 'Julie', 'Pat'):
14 t = Template('Hello, {{ name }}')
15 print t.render(Context({'name': name}))
16
17 # Good
18 t = Template('Hello, {{ name }}')
19 for name in ('John', 'Julie', 'Pat'):
20 print t.render(Context({'name': name}))
Django 模板解析非常快捷。 大部分的解析工作都是在后台通过对简短正则表达式一次性调用来完成。 这和基于 XML 的模板引擎形成鲜明对比,那些引擎承担了 XML 解析器的开销,且往往比 Django 模板渲染引擎要慢上几个数量级。
1 from django.shortcuts import render,HttpResponse
2 from django.template.loader import get_template #记得导入
3 # Create your views here.
4
5
6 import datetime
7 from django.template import Template,Context
8
9 # def current_time(req):
10 #原始的视图函数
11 # now=datetime.datetime.now()
12 # html="<html><body>现在时刻:<h1>%s.</h1></body></html>" %now
13 # return HttpResponse(html)
14
15
16
17 # def current_time(req):
18
19 #django模板修改的视图函数
20 # now=datetime.datetime.now()
21 # t=Template('<html><body>现在时刻是:<h1 style="color:red">{{current_date}}</h1></body></html>')
22 #t=get_template('current_datetime.html')
23 # c=Context({'current_date':now})
24 # html=t.render(c)
25 # return HttpResponse(html)
26
27 #另一种写法(推荐)
28
29 def current_time(req):
30
31 now=datetime.datetime.now()
32
33 return render(req, 'current_datetime.html', {'current_date':now})
34
35 推荐方式
------深度变量的查找(万能的句点号)
在到目前为止的例子中,我们通过 context 传递的简单参数值主要是字符串,然而,模板系统能够非常简洁地处理更加复杂的数据结构,例如list、dictionary和自定义的对象。
在 Django 模板中遍历复杂数据结构的关键是句点字符 (.)。
1 #最好是用几个例子来说明一下。
2 # 首先,句点可用于访问列表索引,例如:
3
4 >>> from django.template import Template, Context
5 >>> t = Template('Item 2 is {{ items.2 }}.')
6 >>> c = Context({'items': ['apples', 'bananas', 'carrots']})
7 >>> t.render(c)
8 'Item 2 is carrots.'
9
10 #假设你要向模板传递一个 Python 字典。 要通过字典键访问该字典的值,可使用一个句点:
11 >>> from django.template import Template, Context
12 >>> person = {'name': 'Sally', 'age': '43'}
13 >>> t = Template('{{ person.name }} is {{ person.age }} years old.')
14 >>> c = Context({'person': person})
15 >>> t.render(c)
16 'Sally is 43 years old.'
17
18 #同样,也可以通过句点来访问对象的属性。 比方说, Python 的 datetime.date 对象有
19 #year 、 month 和 day 几个属性,你同样可以在模板中使用句点来访问这些属性:
20
21 >>> from django.template import Template, Context
22 >>> import datetime
23 >>> d = datetime.date(1993, 5, 2)
24 >>> d.year
25 >>> d.month
26 >>> d.day
27 >>> t = Template('The month is {{ date.month }} and the year is {{ date.year }}.')
28 >>> c = Context({'date': d})
29 >>> t.render(c)
30 'The month is 5 and the year is 1993.'
31
32 # 这个例子使用了一个自定义的类,演示了通过实例变量加一点(dots)来访问它的属性,这个方法适
33 # 用于任意的对象。
34 >>> from django.template import Template, Context
35 >>> class Person(object):
36 ... def __init__(self, first_name, last_name):
37 ... self.first_name, self.last_name = first_name, last_name
38 >>> t = Template('Hello, {{ person.first_name }} {{ person.last_name }}.')
39 >>> c = Context({'person': Person('John', 'Smith')})
40 >>> t.render(c)
41 'Hello, John Smith.'
42
43 # 点语法也可以用来引用对象的方法。 例如,每个 Python 字符串都有 upper() 和 isdigit()
44 # 方法,你在模板中可以使用同样的句点语法来调用它们:
45 >>> from django.template import Template, Context
46 >>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}')
47 >>> t.render(Context({'var': 'hello'}))
48 'hello -- HELLO -- False'
49 >>> t.render(Context({'var': '123'}))
50 '123 -- 123 -- True'
51
52 # 注意这里调用方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数;你只能调用不需参数的
53 # 方法。
------变量的过滤器(filter)的使用
1 语法格式: {{obj|filter:param}}
1 # 1 add : 给变量加上相应的值
2 #
3 # 2 addslashes : 给变量中的引号前加上斜线
4 #
5 # 3 capfirst : 首字母大写
6 #
7 # 4 cut : 从字符串中移除指定的字符
8 #
9 # 5 date : 格式化日期字符串
10 #
11 # 6 default : 如果值是False,就替换成设置的默认值,否则就是用本来的值
12 #
13 # 7 default_if_none: 如果值是None,就替换成设置的默认值,否则就使用本来的值
14
15
16 #实例:
17
18 #value1="aBcDe"
19 {{ value1|upper }}<br>
20
21 #value2=5
22 {{ value2|add:3 }}<br>
23
24 #value3='he llo wo r ld'
25 {{ value3|cut:' ' }}<br>
26
27 #import datetime
28 #value4=datetime.datetime.now()
29 {{ value4|date:'Y-m-d' }}<br>
30
31 #value5=[]
32 {{ value5|default:'空的' }}<br>
33
34 #value6='<a href="#">跳转</a>'
35
36 {{ value6 }}
37
38 {% autoescape off %}
39 {{ value6 }}
40 {% endautoescape %}
41
42 {{ value6|safe }}<br>
43
44 {{ value6|striptags }}
45
46 #value7='1234'
47 {{ value7|filesizeformat }}<br>
48 {{ value7|first }}<br>
49 {{ value7|length }}<br>
50 {{ value7|slice:":-1" }}<br>
51
52 #value8='http://www.baidu.com/?a=1&b=3'
53 {{ value8|urlencode }}<br>
54 value9='hello I am yuan'
3.2 标签(tag)的使用(使用大括号和百分比的组合来表示使用tag)
1 {% tags %}
------{% if %} 的使用
{% if %}标签计算一个变量值,如果是“true”,即它存在、不为空并且不是false的boolean值,系统则会显示{% if %}和{% endif %}间的所有内容
1 {% if num >= 100 and 8 %}
2
3 {% if num > 200 %}
4 <p>num大于200</p>
5 {% else %}
6 <p>num大于100小于200</p>
7 {% endif %}
8
9 {% elif num < 100%}
10 <p>num小于100</p>
11
12 {% else %}
13 <p>num等于100</p>
14
15 {% endif %}
16
17
18
19 {% if %} 标签接受and,or或者not来测试多个变量值或者否定一个给定的变量
20 {% if %} 标签不允许同一标签里同时出现and和or,否则逻辑容易产生歧义,例如下面的标签是不合法的:
21
22 {% if obj1 and obj2 or obj3 %}
------{% for %}的使用
{% for %}标签允许你按顺序遍历一个序列中的各个元素,每次循环模板系统都会渲染{% for %}和{% endfor %}之间的所有内容
1 <ul>
2 {% for obj in list %}
3 <li>{{ obj.name }}</li>
4 {% endfor %}
5 </ul>
6
7
8 #在标签里添加reversed来反序循环列表:
9
10 {% for obj in list reversed %}
11 ...
12 {% endfor %}
13
14 #{% for %}标签可以嵌套:
15
16 {% for country in countries %}
17 <h1>{{ country.name }}</h1>
18 <ul>
19 {% for city in country.city_list %}
20 <li>{{ city }}</li>
21 {% endfor %}
22 </ul>
23 {% endfor %}
24
25
26 #系统不支持中断循环,系统也不支持continue语句,{% for %}标签内置了一个forloop模板变量,
27 #这个变量含有一些属性可以提供给你一些关于循环的信息
28
29 1,forloop.counter表示循环的次数,它从1开始计数,第一次循环设为1:
30
31 {% for item in todo_list %}
32 <p>{{ forloop.counter }}: {{ item }}</p>
33 {% endfor %}
34 2,forloop.counter0 类似于forloop.counter,但它是从0开始计数,第一次循环设为0
35 3,forloop.revcounter
36 4,forloop.revcounter0
37 5,forloop.first当第一次循环时值为True,在特别情况下很有用:
38
39
40 {% for object in objects %}
41 {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}
42 {{ object }}
43 </li>
44 {% endfor %}
45
46 # 富有魔力的forloop变量只能在循环中得到,当模板解析器到达{% endfor %}时forloop就消失了
47 # 如果你的模板context已经包含一个叫forloop的变量,Django会用{% for %}标签替代它
48 # Django会在for标签的块中覆盖你定义的forloop变量的值
49 # 在其他非循环的地方,你的forloop变量仍然可用
50
51
52 #{% empty %}
53
54 {{li }}
55 {% for i in li %}
56 <li>{{ forloop.counter0 }}----{{ i }}</li>
57 {% empty %}
58 <li>this is empty!</li>
59 {% endfor %}
60
61 # [11, 22, 33, 44, 55]
62 # 0----11
63 # 1----22
64 # 2----33
65 # 3----44
66 # 4----55
------{%csrf_token%}:csrf_token标签
用于生成csrf_token的标签,用于防治跨站攻击验证。注意如果你在view的index里用的是render_to_response方法,不会生效
其实,这里是会生成一个input标签,和其他表单标签一起提交给后台的。
------{% url %}: 引用路由配置的地址
1 <form action="{% url "bieming"%}" >
2 <input type="text">
3 <input type="submit"value="提交">
4 {%csrf_token%}
5 </form>
------{% with %}:用更简单的变量名替代复杂的变量名
1 {% with total=fhjsaldfhjsdfhlasdfhljsdal %} {{ total }} {% endwith %}
------{% verbatim %}: 禁止render
1 {% verbatim %}
2 {{ hello }}
3 {% endverbatim %}
------{% load %}: 加载标签库
3.3 自定义filter和simple_tag
------a、在app中创建templatetags模块(必须的)
------b、创建任意 .py 文件,如:my_tags.py
1 from django import template
2 from django.utils.safestring import mark_safe
3
4 register = template.Library() #register的名字是固定的,不可改变
5
6
7 @register.filter
8 def filter_multi(v1,v2):
9 return v1 * v2
10
11
12 @register.simple_tag
13 def simple_tag_multi(v1,v2):
14 return v1 * v2
15
16
17 @register.simple_tag
18 def my_input(id,arg):
19 result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
20 return mark_safe(result)
------c、在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py :{% load my_tags %}
------d、使用simple_tag和filter(如何调用)
1 -------------------------------.html
2 {% load xxx %} #首行
3
4
5
6
7 # num=12
8 {{ num|filter_multi:2 }} #24
9
10 {{ num|filter_multi:"[22,333,4444]" }}
11
12
13 {% simple_tag_multi 2 5 %} 参数不限,但不能放在if for语句中
14 {% simple_tag_multi num 5 %}
------e、在settings中的INSTALLED_APPS配置当前app,不然django无法找到自定义的simple_tag.
注意:
filter可以用在if等语句后,simple_tag不可以
1 {% if num|filter_multi:30 > 100 %}
2 {{ num|filter_multi:30 }}
3 {% endif %}
3.4 extend模板继承
------include 模板标签
在讲解了模板加载机制之后,我们再介绍一个利用该机制的内建模板标签: {% include %} 。该标签允许在(模板中)包含其它的模板的内容。 标签的参数是所要包含的模板名称,可以是一个变量,也可以是用单/双引号硬编码的字符串。 每当在多个模板中出现相同的代码时,就应该考虑是否要使用 {% include %} 来减少重复。
------extend(继承)模板标签
本质上来说,模板继承就是先构造一个基础框架模板,而后在其子模板中对它所包含站点公用部分和定义块进行重载。从而减少共用页面区域(比如站点导航)所引起的重复和冗余代码
示例:
1 {% extends "base.html" %}
2
3 {% block title %}Future time{% endblock %}
4
5 {% block content %}
6 <p>In {{ hour_offset }} hour(s), it will be {{ next_time }}.</p>
7 {% endblock %}
每个模板只包含对自己而言 独一无二 的代码。 无需多余的部分。 如果想进行站点级的设计修改,仅需修改 base.html ,所有其它模板会立即反映出所作修改。
以下是使用模板继承的一些诀窍:
<1>如果在模板中使用 {% extends %} ,必须保证其为模板中的第一个模板标记。 否则,模板继承将不起作用。
<2>一般来说,基础模板中的 {% block %} 标签越多越好。 记住,子模板不必定义父模板中所有的代码块,因此
你可以用合理的缺省值对一些代码块进行填充,然后只对子模板所需的代码块进行(重)定义。 俗话说,钩子越
多越好。
<3>如果发觉自己在多个模板之间拷贝代码,你应该考虑将该代码段放置到父模板的某个 {% block %} 中。
如果你需要访问父模板中的块的内容,使用 {{ block.super }}这个标签吧,这一个魔法变量将会表现出父模
板中的内容。 如果只想在上级代码块基础上添加内容,而不是全部重载,该变量就显得非常有用了。
<4>不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。
也就是说,block 标签不仅挖了一个要填的坑,也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个
相同名称的 {% block %} 标签,父模板将无从得知要使用哪个块的内容。