Django的模板层
def current_time(request): now = datetime.datetime.now() html = "<html><body>It is now %s.</body></html>"%now return HttpResponse(html)
在上面这个例子中,视图返回文本的方式是将HTML直接硬编码在python代码之中.虽然这种方式便于解释视图是如何工作的,但并不是一个好方法.
原因:
①对页面设计进行的任何改变都必须对python代码进行相应的修改,站点设计的修改往往比底层python代码的修改要频繁的多.因此如果可以在不进行python代码修改的情况下变更设计,将会方便许多.
②python代码编写和HTML设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成.设计者和HTML/CSS的编码人员不应该被要求去编辑python的代码来完成他们的工作.
③程序员编写python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含python又包含HTML的文件的编辑工作.
基于这些原因,将页面的设计和python的代码分离开会更干净简洁更容易维护.我们可以用Django的模板系统(Template System)来实现这种模式.
def current_time(req): # ================================原始的视图函数 # import datetime # now=datetime.datetime.now() # html="<html><body>现在时刻：<h1>%s.</h1></body></html>" %now # ================================django模板修改的视图函数 # from django.template import Template,Context # now=datetime.datetime.now() # t=Template('<html><body>现在时刻是:<h1>{{current_date}}</h1></body></html>') # #t=get_template('current_datetime.html') # c=Context({'current_date':str(now)}) # html=t.render(c) # # return HttpResponse(html) #另一种写法(推荐) import datetime now=datetime.datetime.now() return render(req, 'current_datetime.html', {'current_date':str(now)[:19]})
模板语法之变量
在Django模板中遍历复杂数据结构的关键是句点字符,语法:
{{var_name}}
views.py
import datetime def index(request): s = "hello" l = [111,222,333] #列表 dic = {"name":"dsb","age":18} #字典 date = datetime.date(2018, 1, 1) #日期对象 class Person(object): def __init__(self, name): self.name = name person_dsm = Person("dsm") person_dmh = Person("dsm") person_dac = Person("dac") person_list = [person_dsm, person_dmh, person_dac] return {"1":1, "dic":dic, "date":date, "person_list":person_list}
template:
1 <h4>{{2}}</h4> 2 <h4>列表:{{l.0}}</h4> 3 <h4>列表:{{l.2}}</h4> 4 <h4>字典:{{dic.name}}</h4> 5 <h4>日期:{{date.year}}</h4> 6 <h4>类对象列表:{{person_list.0.name}}</h4>
注意:句点符(.)也可以用来引用对象的方法(无参数方法)
<h4>字典:{{dic.name.upper}}</h4>
模板之过滤器
语法:
{{obj|filter__name:param}}
default
如果一个变量是false或者为空,使用给定的默认值,否则使用变量的值
{{value|default:"nothing"}}
length
返回值的长度,对字符串和列表都起作用
{{value|length}} #如果value是["a","b","c","d"],那么输出是4
filesizeformat
将值格式化为一个"人类可读的"文件尺寸,例如:10KB,1MB,100bytes等等.
{{value|filesizeformat}} #如果value是123456789,输出将会是117.7MB
date
如果value=datetime.datetime.now()
{{value|date:"Y-m-d"}}
slice:切片
如果value="hello world"
{{value|slice:"2:-1"}} #llo worl
truncatechars
如果字符串字符多于指定的字符数量,那么会被截断.截断的字符串将以可以翻译的省略号序列("...")结尾
参数:要截断的字符数
{{value|truncatechars:9}}
safe
Django的模板中会对HTML标签和JS等语法标签进行自动转义,这样是为了安全.但是有时候不希望这些HTML元素被转义,比如做了一个内容管理系统,后台添加的我呢张是经过修饰的,这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本,如果自动转义的话显示的就是保护HTML标签的源文件.为了在Django中关闭HTML的自动转义有两种方式,如果是一个单独的变量可以通过过滤器"|safe"的方式告诉Django这段代码是安全的不必转义.比如:
value = "<a href="">点击</a>" {{value|safe}}
模板之标签
标签看起来像是这样的:{% tag %}.标签比变量更加复杂,一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模板中.一些标签需要开始和结束标签(例如{% tag %})...标签内容...{% endtag %}
for标签
遍历每一个元素:
{% for person in person_list %} <p>{{ person.name }}</p> {% endfor %}
可以利用{% for obj in list reversed %}反向完成循环
遍历一个字典:
{% for key,val in dic.items %} <p>{{ key }}:{{ val }}</p> {% endfor %}
·循环序号可以通过{ {forloop} }显示
for....empty
for标签带有一个可选的{% empty %}从句,以便在给出的组是空的或者没有被找到时,可以有所操作.
{% for person in person_list %} <p>{{ person.name }}</p> {% empty %} <p>this is empty</p> {% endfor %}
if标签
{% if %}会对一个变量求值,如果它的值是"True"(存在,不为空,且不是boolean类型的false值),对应的内容快会输出.
{% if num > 100 or num < 0 %}
<p>无效</p>
{% endif num >80 and num < 100 %{
<p>真秀</p>
{% else %}
<p>还行</p>
{% endif %}
with
使用一个简单的名字缓存一个复杂的变量,当你需要一个使用很多次的方法(比如访问数据库)的时候是非常有用的
例如:
{% with total = bussiness.employees.count %}
{{ total }} employee {{ total|pluralize }}
{% endwith %}
csrf_token
这个标签用于跨站请求伪造保护
自定义标签和过滤器
1. 在settings中的INSTALLED_APPS配置当前app,不然Django无法找到自定义的simple_tag
2. 在app中创建templatetags模块(模块名只能是templatetags)
3. 创建任意.py文件,如my_tags.py
from django import template from django.utils.safestring import mark_safe register = template.Library() #register的名字是固定的,不可改变 @register.filter def filter_multi(v1, v2): return v1*v2 @register.simple_tag def simple_tag_multi(v1, v2): return v1*v2 @register.simple_tag def my_input(id, arg): result = "<input type='text' id='%s' class='%s'/>"%(id, arg) return mark_safe(result)
4. 在使用自定义simple_tag和filter的html文件中导入之前创建的my_tags.py
{% load my_tags %}
5. 使用simple_tag 和 filter(如何调用)
{% load xxx %}
#num=12
{{ num|filter_multi:2 }} #24
{{ num|filter_multi:"[22,33,44]" }}
{% simple_tag_multi 2 5 %} 参数不限,但不能放在if for语句中
{% somple_tag_multi num 5 %}
注意: filter可以用在if等语句后,simple_tag不可以
{% if num|filter_multi:30 > 100 %}
{{ num|filter_multi:30 }}
{% endif %}
模板继承(extend)
Django模板引擎中最强大的也是最复杂额部分就是模板继承了,模板继承可以创建一个基本的"骨架"模板,它包含站点中的全部元素,并且可以定义能够被子模板覆盖的block
base.html
<!DOCTYPE html> <html lang="en"> <head> <link rel="stylesheet" href="style.css" /> <title>{% block title %}My amazing site{%/span> endblock %}</title> </head> <body> <div id="sidebar"> {% block sidebar %} <ul> <li><a href="/">Home</a></li> <li><a href="/blog/">Blog</a></li> </ul> {% endblock %} </div> <div id="content"> {% block content %}{% endblock %} </div> </body> </html>
这个模板叫做base.html,它定义了一个可以用于两列排版页面的简单的HTML骨架.子模板的工作是用它们的内容填充空的block.
在这个例子中,block标签定义了三个可以被子模板内容填充的block.block告诉模板引擎:子模板可能会覆盖掉模板中的这些位置.
子模板:
index.html
{% extends "base.html" %} {% block title %} 子模板 {% endblock %} {% block content %} {% for customer in customer_list %} <h2>{{ customer.name }} </h2> {% endfor %} {% endblock %}
extends标签告诉模板引擎,这个模板继承了另一个模板.当模板系统处理这个模板时,首先,它将定位父模板,在此例中,就是"base.html".
这时,模板引擎将注意到base.html中的block标签,并用子模板中的内容来替换这些block.根据customer_list的值.
