Django模板语言
Django模板是一个简单的文本文档，或用Django模板语言标记的一个Python字符串。 某些结构是被模板引擎解释和识别的。主要的有变量和标签。模板是由context来进行渲染的。渲染的过程是用在context中找到的值来替换模板中相应的变量，并执行相关tags。其他的一切都原样输出。Django模板语言的语法包括四个结构。
Django 项目可以配置一个或多个模板引擎（甚至是零，如果你不需要使用模板）。Django 的模板系统自带内建的后台 —— 称为Django 模板语言（DTL），以及另外一种流行的Jinja2。其他的模板语言的后端，可查找第三方库。
配置
模板引擎通过TEMPLATES 设置来配置。它是一个设置选项列表，与引擎一一对应。默认的值为空。由startproject 命令生成的settings.py 定义了一些有用的值：
代码语言：javascript复制TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True,
'OPTIONS': {
# ... some options here ...
},
},
]加载模板
代码语言：javascript复制get_template('news/story_detail.html')1 变量(使用双大括号来引用变量)
代码语言：javascript复制 {{ var_name }}2 标签(tag)的使用(使用大括号和百分号组成来表示使用tag)
代码语言：javascript复制{% load staticfiles %}3 过滤器(filter)的使用
代码语言：javascript复制{{ ship_date|date:"Fj,Y"}}ship_date变量传给data过滤器，data过滤器通过使用Fj,Y这几个参数来格式化数据。|代表类似Unix命令中的管道操作。
常用标签(tag)
1 {% if %}
- 可以使用and,or,not来组织你的逻辑，但不允许and和or同时出现的条件语句中。新版本已经支持{% elif %}这样的用法
2 {% ifequal %}和{% ifnotequal %}
- 比较是否相等，只限于简单的类型，比如字符串、整数、小数的比较,列表、字典、元组不支持。
3 {% for %}
- 用来循环一个list,还可以使用reserved关键字来进行倒序遍历，一般可以用if语句来西先判断一下列表是否为空，在进行遍历；还可以使用empty关键字来进行为空时候的跳转。
- **for标签中可以使用forloop
forloop.counter: 当前循环计数，从1开始
forloop.counter0: 当前循环计数，从0开始
forloop.recounter: 当前循环倒数计数，从列表长度开始
forloop.recounter0: 当前循环倒数计数，从列表长度减1开始，标准
forloop.first: bool值，判断是不是循环的第一个元素
forloop.last: bool值，判断是不是循环的最后一个元素
forloop.parentloop: 用在嵌套循环中，得到parent循环的引用，然后可以使用以上参数4 {% cycle %}
- 在循环是轮流使用给定的字符串列表中的值。
5 注释
{# #}单行注释，{% comment %}多行注释
6 {% csrf_token %}
- 生成csrf_token的标签，用于防止跨站攻击验证
7 {% debug %}
- 调用调试信息
8 {% filter %}
- 将filter标签标签圈定的执行过滤器操作
9 {% autoescape %}
- 自动转义设置
{{% autoescape off %}}
{{ value}}
{{% endautoescape %}}10 {% firstof %}
- 输出第一个值不等于False的变量
11 {% load %}
- 加载标签库
12 {% now %}
- 获取当前的时间
13 {% spaceless %}
- 移除空格
14 {% url %}
- 引入路由配置的地址
15 {% verbatim %}
- 禁止render
16 {% with %}
- 用更简单的变量名缓存复制的变量名
常用过滤器(filter)
- 经常使用的是通过变量来调用过滤器)
1 add
- 给变量加上相应的值
{{ value|add:"2" }} # 空格不要乱加2 addslashes
- 给变量中的引号(双引号、单引号)前加上斜线
3 capfirst
- 首字母大写
4 cut
- 从字符串中移除指定的字符
{{ value|cut:" " }}5 date
- 格式化日期字符串
6 default
- 如果值是False，就替换成设置的默认值，否则就使用本来的值(空字符串”“、空列表[]、空字典{}、空元组()、None在python里也是False)
7 default_if_none
- 如果只是None，就替换成设置的默认值，否则就使用本来的值
8 dictsort
- 按照设定的参数(key)对应的value对列表进行排序
9 dictsorted
- 和上面恰好相反
10 divisbleby
- 是否能够被某个数字整除，是的话返回True，否则返回False
11 escape
- 对字符串进行转义。django默认自动转义，如果我们关闭了自动转义，这可使用escape过滤器来转义。
12 escapejs
- 替换value中的某些字符，以适应JAVASCRIPT和JSON格式
13 filesizeformat
- 格式化文件大小显示
14 first
- 返回列表中的第一个值
15 last
- 返回列表中的最后一个值
16 floatformat
- 格式化浮点数
17 length
- 求字符串或者列表的长度
18 length_is
- 比较字符串或者列表的长度
19 urlencode
- 对URL进行编码处理
20 upperlower
- 大写小写
21 safe
- 对某个变量关闭自动转义
{{ value|safe }}22 slice
- 切片操作
{{ some_list|slice:":2" }}23 time
- 格式化时间
24 timesince
- 格式化时间(e.g. “4 days,6 hours”)
25 truncatechars
- 按照字符截取字符串
{{ value|truncatechars:5 }}26 turncatewords
- 按照单词截取字符串(其实就是按照空格来截取)
27 striptags
- 过滤掉html标签
具体可以查看 内置过滤器参考和 开发自定义过滤器指南这两篇文档.
include模板
{% include 'included.html' %}标签允许在模板中包含其它的模板的内容。
模板继承
模板可以通过继承来实现复用。首先编写base.html
代码语言：javascript复制<html>
<head>
<title>Hello World!</title>
</head>
<body>
{% block mainbody %}
<p>base</p>
{% endblock %}
</body>
</html>{% block %}标签通知模板引擎，子模板可以重写这些部分。
{% extends "base.html" %}
{% block mainbody %}
<p>extends base</p>
{% endblock %}模版继承可以让您创建一个基本的“骨架”模版，它包含您站点中的全部元素，并且可以定义能够被子模版覆盖的 blocks 。
加载器
模板加载器负责定位模板，加载它们，并返回模板对象.
Django提供几个内置的模板加载器并且支持自定义的模板加载器.
上下文处理器
Context处理器是这样的函数：接收当前的 HttpRequest 作为参数，并返回一个 字典，该字典中包含了将要添加到渲染的context中的数据。
它们的主要用途是添加所有的模板context共享的公共数据，而不需要在每个视图中重复代码。
Django提供了很多 内置的context处理器 . 实现自定义context处理器很简单，只要定义一个函数。
大家使用Django的模板的时候可能都用过{{request.user}}来获取登录的用户或者判断是否登录呢？那大家有没有想过，我们调用render方法的时候并没有把request对象作为参数传给模板啊，为什么就可以直接调用呢？答案就是Django默认自带了一些context_processors帮我们把request对象传给模板，我们来看一下settings.py这一段代码
-
TEMPLATES = [ -
{ -
'BACKEND': 'django.template.backends.django.DjangoTemplates', -
'DIRS': [os.path.join(BASE_DIR, 'templates')] -
, -
'APP_DIRS': True, -
'OPTIONS': { -
'context_processors': [ -
'django.template.context_processors.debug', -
'django.template.context_processors.request', -
'django.contrib.auth.context_processors.auth', -
'django.contrib.messages.context_processors.messages', -
], -
}, -
}, -
]
这里面的context_processors就是配置模板有哪些context_processors可以使用。其中django.template.context_processors.request就是帮我们把request传递给模板的，我们来看一下
def request(request):
-
return {'request': request}
可以看到，首先context_processors就是一个函数，其次，这个函数默认接受一个参数，也就是request，最后，返回的对象是一个字典，字典的key就是我们在模板里面可以调用的一个上下文。
那么我们来建一个自己的context_processors
创建context_processors
首先我们在自己app里创建一个context_processors.py的文件（模块），文件名虽然不是强制要求，但作为规范，建议还是按照规范来
然后里面实现一个context_processors的函数，比如我们就是把settings里的某一个参数作为上下文返回，可以这样写
-
from django.conf import settings # import the settings file -
def site_name(request): -
# return the value you want as a dictionnary. you may add multiple values in there. -
return {'SITE_NAME': settings.SITE_NAME}
说明：
settings.SITE_NAME是一个自定义的配置，默认并不存在，需要我们手动写。另外可以返回多个值，只要配置多个key和value对儿就可以了。 注意：request形参必须有，尽管多数用不到。
配置context_processors
接下来就可以把我们自定义的context_processors添加到配置文件中
TEMPLATES = [
- 接下来就可以把我们自定义的
context_processors添加到配置文件中 -
TEMPLATES = [ -
{ -
... -
'OPTIONS': { - 说明：
blog是这个例子的应用名，根据自己的项目做相应修改。 注意：别忘了配置SITE_NAME哦。 大功告成 这样我们就可以在我们的模板通过{{SITE_NAME}}等方式调用这个参数了 -
'context_processors': [ -
... -
'blog.context_processors.site_name', -
], -
}, -
}, -
] -
... -
SITE_NAME = "社区" -
{ -
... -
'OPTIONS': { -
'context_processors': [ -
... -
'blog.context_processors.site_name', -
], -
}, -
}, -
] -
... -
SITE_NAME = "社区"
说明：
blog是这个例子的应用名，根据自己的项目做相应修改。 注意：别忘了配置SITE_NAME哦。
