python框架django文档_Django框架-Django模板（template）系统

Django模板系统

一、什么是模板？

只要是在html里面有模板语法就不是html文件了，这样的文件就叫做模板。

二、模板语法分类

Django模板中主要有两种特殊的符号：

{{ }}  &    {%  % }

{{}} 表示变量，在模板渲染的时候替换成后台传过来的值，{% %}表示逻辑相关的操作。

2.1、模板语法之变量：语法为 {{ 变量名 }}：

在 Django 模板中遍历复杂数据结构的关键是句点字符  .(也就是点)，用来获取对象的相应属性值

views.py

def index(request):

name = "hello haiyan"

i = 200

l = [11,22,33,44,55]

d = {"name":"haiyan","age":20}

class People(object): #继承元类

def __init__(self,name,age):

self.name = name

self.age = age

def __str__(self):

return self.name+str(self.age)

def dream(self):

return "你有梦想吗？"

#实例化

person_egon = People("egon",10)

person_dada = People("dada",34)

person_susan = People("susan",34)

person_list = [person_dada,person_egon,person_susan]

return render(request,"index.html",

{

"name":name,

"i":i,

"l":l,

"d":d, #键对应的是模板里的变量名，值对应的是上面定义的变量

"person_egon":person_egon,

"person_dada":person_dada,

"person_list":person_list,

}

)

# return render(request,"index.html",locals())

#用locals()可以不用写上面的render了。不过用locals()，views里面用什么名。模板里面就得用什么名

# locals()局部的：用了locals就相当于都得按照上面的那样

template/index.html

变量{{ z }}:深度查询

---

{{ name }}

{{ i }}

{{ l }}

{{ d }}

{{ l.0 }}------》取单个值可通过句点符(也就是点)

{{ l.4 }}

# 取l中的第五个参数

{{ d.name }}

{{ d.age }}-----》字典也可以根据句点符取值，一个点就搞定了。

然而在前端页面中是看不到你的模板语法的，当你点击审查元素的

时候，你就会发现，偷偷的换过来了

{{ person_dada.name }}

{{ person_egon.age }}

{{ person_dada.dream }}

{{ person_list.2 }}

{{ person_list.1.name }}

注意：句点符也可以用来引用对象的方法(无参数方法)。

字典:{{ dic.name.upper }}

. 操作只能调用不带参数的方法，且模板中调用对象的方法时不用写括号

当模板系统遇到一个(.)时，会按照如下的顺序取查询：

1、在字典中查询

2、属性或者方法

3、数字索引

2.2、模板语法之标签：语法为 {% tag  %}：

标签看起来像是这样的： {% tag %}。标签比变量更加复杂：一些在输出中创建文本，一些通过循环或逻辑来控制流程，一些加载其后的变量将使用到的额外信息到模版中。

一些标签需要开始和结束标签 (例如{% tag %} ...标签 内容 ... {% endtag %})。

2.2.1、for标签(注：循环序号可以通过｛｛forloop｝｝显示)

循环取值1

---

{% for item in person_list %}

{{ item.name }},{{ item.age }}

{% endfor %}

循环取值2:倒序

---

{% for item in person_list reversed %}

{{ forloop.counter }}----->{{ item.name }},{{ item.age }}

{{ forloop.counter0 }}----->{{ item.name }},{{ item.age }}

{{ forloop.revcounter }}----->{{ item.name }},{{ item.age }}

{% endfor %}

循环取值3：字典

---

{% for k,v in d.items %}

{{ k }},{{ v}}

{% endfor %}

for循环可用的一些参数：

VariableDescription

forloop.counter

当前循环的索引值(从1开始)

forloop.counter0

当前循环的索引值(从0开始)

forloop.revcounter

当前循环的倒序索引值(从1开始)

forloop.revcounter0

当前循环的倒序索引值(从0开始)

forloop.first

当前循环是不是第一次循环(布尔值)

forloop.last

当前循环是不是最后一次循环(布尔值)

forloop.parentloop

本层循环的外层循环

2.2.2、for....empty ：for 标签带有一个可选的{% empty %} 从句，以便在给出的组是空的或者没有被找到时，可以有所操作。

{% for person in person_list %}

{{ person.name }}

{% empty %}

sorry,no person here

{% endfor %}

2.2.3、if标签 ：{% if %}会对一个变量求值，如果它的值是“True”(存在、不为空、且不是boolean类型的false值)，对应的内容块会输出。

{% if i > 300 %}

大于{{ i }}

{% elif i == 200 %}

等于{{ i }}

{% else %}

小于{{ i }}

{% endif %}

if语句支持 and 、or、==、>、=、in、not in、is、is not判断。

4、with：使用一个简单地名字缓存一个复杂的变量，当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的

{% with total=business.employees.count %}

{{ total }} employee{{ total|pluralize }}

{% endwith %}

{{ person_list.2.name }}

{% with name=person_list.2.name %}

{{ name }}

{% endwith %}

5、csrf_token：这个标签用于跨站请求伪造保护

提交数据的时候就会做安全机制，当你点击提交的时候会出现一个forbbiddon

的错误，就是用setting配置里的scrf做安全机制的，那么我们可以吧它给注释了，，，

或者在form表单下面添加一个{% csrf_token %},,,

这才是真正解决的办法，注释不是解决的办法

scrf_token

{% csrf_token %}

6、注释

{#......#}

注意事项：

1、Django的模板语言不支持连续判断，即不支持以下写法

{% if a > b > c %}

……

{% endif %}

2. 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的值。

2.3、模板语法之过滤器：语法 {{obj|filter__name:param}}

‘|’左右没有空格

1、default：如果一个变量是false或者为空，使用给定的默认值。否则，使用变量的值。例如：

default过滤器：{{ li|default:"如果显示为空，设置的解释性的内容" }}

注：TEMPLATES的OPTIONS可以增加一个选项：string_if_invalid：‘找不到‘，可以替代default的的作用。

2、length：返回值的长度。它对字符串和列表都起作用。例如：

{{ value|length }}

如果 value 是 [‘a‘, ‘b‘, ‘c‘, ‘d‘]，那么输出是 4。

3、filesizeformat：将值格式化为一个 “人类可读的” 文件尺寸 (例如 ‘13 KB‘, ‘4.1 MB‘, ‘102 bytes‘, 等等)。例如：

{{ value|filesizeformat }}

如果 value 是 123456789，输出将会是 117.7 MB。

4、date：如果 value=datetime.datetime.now()

{{ value|date:"Y-m-d H:i:s" }}

输出结果：2016-03-05 12：08：30

可格式化输出的字符：点击查看。

注：如果有很多操作时间的操作，需要固定的模式的话如：2016-03-05 12：03：05

可以在settings.py里配置如下：

USE_L10N = FALSE

DATETIME_FORMAT = ‘y-m-d H:i:s‘

# 修改django默认时间格式

之后模板中引用时间，不用过滤器date，显示的就是默认时间格式，

当然也可以自定义格式，如{date_current|date ‘Y-m-d‘}

5、slice  ：切片

如果 value="hello world"

{{ value|slice:"2:-1" }}

6、truncatechars  截断

如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列(“...”)结尾。

参数：要截断的字符数

例如：

截断字符：{{ content|truncatechars:20 }}

截断单词：{{ content|truncatewords:4 }}

如果content是“I am is haiyan,how are you asd df dfgfdgdg?

输出结果： 截断字符：I am is haiyan,ho...

输出结果 ：截断单词：I am is haiyan,how ...

7、safe

Django的模板中会对HTML标签和JS等语法标签进行自动转义，原因显而易见，这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义，比如我们做一个内容管理系统，后台添加的文章中是经过修饰的，这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本，如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式，如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。比如：

value="点击"

{{ value|safe}}

{{ label }}

{{ label|safe }}

8、add ：给变量加参数

views.py

def test(request):

return render(request, {‘value‘:4})

test.html

{{value|add:2}}

=》则输出结果为6

字符串，列表等也可以相加

9、upper/lower/title/ljust/rjust/center/first/last  字符串方法

{string|upper|title}

注：可以链式操作

10、join  使用字符串拼接列表，同python的str.join(list)

四、自定义标签和过滤器:filter、simple_tg、inclusion_tag

在项目中的配置都是下面的步骤：

1、在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.

2、在app中创建templatetags包(包名只能是templatetags)

3、在templatetags里面创建任意 .py 文件，

4、在创建的py文件中编辑：

from django  import  template

register = template.Library()

如：my_tags.py

from django import template

from django.utils.safestring import mark_safe

register = template.Library() #register的名字是固定的,不可改变

@register.filter 过滤器

def multi(x,y):

return x*y

@register.simple_tag 标签

def multitag(x,y,z):

return x*y*z

@register.simple_tag(name= ‘设置别名后模板就只能使用别名，不能使用函数名‘) 标签

def my_input(id,arg):

result = "" %(id,arg,)

return mark_safe(result)

@register.inclusion_tag(‘pag.html‘)

def pag(total,current):

return {‘total‘: range(1,total+1),‘current‘:current}

5、写好自定义的过滤器或标签后重启项目，后面就可以引用了

6、在使用自定义simple_tag和filter、inclusion_tag的html文件中导入之前创建的 my_tags.py

三种自定义过滤/标签，要想在模板中引用，方式都一样

语法：{% load py文件名 %}

{% load my_tags %}

7、使用simple_tag和filter(如何调用)

过滤器： {{ var|filter_name:参数 }} # 参数只能是两个，一个参数是变量var ，一个是参数是后面的那个参数

标签： {% simple_tag 参数1 参数2 ... %}

-------------------------------.html

{% load xxx %}

# num=12

{{ num|multi:2 }} #24

{{ num|multi:"[22,333,4444]" }} 相当于复制了，吧[22,333,4444]乘了num遍

{% multitag 2 5 6 %} 参数不限,但不能放在if for语句中 {% simple_tag_multi num 5 %}

自定义过滤器函数的参数只能两个，可以进行逻辑判断

自定义标签无参数限制，不能进行逻辑判断

{% if i|multi:5 > 1000 %}

大于{{ i }}

{% else %}

大于等于{{ i }}

{% endif %}

8、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<1else int(n)

data= ["第{}项".format(i)for i in range(1, n+1)]

return {"data": data}

templates/result.html

• {% for choice in data %}
• {{ choice }}{% endfor %}

templates/index.html

inclusion_tag test

{% show_results 10 %}