【django 学习笔记】08-模板高级进阶

django的模板系统默认开启html转义，

关闭方法

a.safe过滤器：

{{ data|safe }}

b.对于模板快

#停止自动转义

{% autoescape off %}

#开始自动转义

{% autoescape on %}

{% endautoescape %}

{% endautoescape %}

两种加载模板的方法

a.django.template.loader.get_template(template_name) : get_template
根据给定的模板名称返回一个已编译的模板(一个 Template 对象)。 如果模板不存在,就触发 TemplateDoesNotExist
的异常。

b.django.template.loader.select_template(template_name_list) :
select_template 很像get_template ,不过它是以模板名称的列表作为参数的。
它会返回列表中存在的第一个模板。如果模板都不存在,将会触发TemplateDoesNotExist异常。

创建一个模板库

步骤：

第一,决定模板库应该放在哪个Django应用下。如果你通过 manage.py startapp
创建了一个应用,你可以把它放在那里,或者你可以为模板库单独创建一个应用。
我们更推荐使用后者,因为你的filter可能在后来的工程中有用。无论你采用何种方式,请确保把你的应用添加到 INSTALLED_APPS 中。
我们稍后会解释这一点。

第二,在适当的Django应用包里创建一个 templatetags 目录。 这个目录应当和 models.py 、
views.py等处于同一层次。 例如:

books/

__init__.py

models.py

templatetags/

views.py

在 templatetags 中创建两个空文件: 一个 __init__.py (告诉Python这是
一个包含了Python代码的包)和一个用来存放你自定义的标签/过滤器定义的文件。 第二个文件的名字稍后将用来加载标签。
例如,如果你的自定义标签/过滤器在一个叫作 poll_extras.py 的文件中,你需要在模板中写入如下内容:

{% load poll_extras %}

{% load %}

标签检查 INSTALLED_APPS 中的设置,仅允许加载已安装的Django应用程序中的模板库。
这是一个安全特性;它可以让你在一台电脑上部署很多的模板库的代码,而又不用把它们暴露给每一个Django安装。

自定义过滤器

自定义过滤器就是有一个或两个参数的Python函数:

a.(输入)变量的值

b.参数的值, 可以是默认值或者完全留空

如：{{ var|foo:”bar” }} 中过滤器 foo 会被传入变量 var 和默认参数 bar 。

当你定义完过滤器后,你需要用 Library 实例来注册它,这样就能通过Django的模板语言来使用了:

register.filter(‘cut’, cut)

register.filter(‘lower’, lower)

Library.filter() 方法需要两个参数:

a.过滤器的名称(一个字串)

b.过滤器函数本身

下面是一个完整的模板库的例子,它包含一个 cut 过滤器:

from django import template

register = template.Library()

@register.filter(name=’cut’)

def cut(value, arg):

return value.replace(arg, ”)

自定义模板标签

由于相对复杂，请参考文档相应章节

简单标签的快捷方式

simple_tag是django.template.Library的一个方法

def current_time(format_string):

try:

return datetime.datetime.now().strftime(str(format_string))

except UnicodeEncodeError:

return ”

register.simple_tag(current_time)

需要注意下面一些事情:

a.传递给我们的函数的只有(单个)参数。

b.在我们的函数被调用的时候,检查必需参数个数的工作已经完成了,所以我们不需要再做这个工作。

c.参数两边的引号(如果有的话)已经被截掉了,所以我们会接收到一个普通Unicode字符串。

包含标签

另外一类常用的模板标签是通过渲染 其他 模板显示数据的。

编写自定义波板加载器

模板加载器,也就是 TEMPLATE_LOADERS 中的每一项,都要能被下面这个接口调用:

load_template_source(template_name, template_dirs=None)

可以从ZIP文件中加载模板。 它使用了自定义的设置 TEMPLATE_ZIP_FILES 来取代了 TEMPLATE_DIRS
用作查找路径,并且它假设在此路径上的每一个文件都是包含模板的ZIP文件