通过《如何创建一个Django网站》大概清楚了如何创建一个简单的 Django 网站，这篇文章主要是在此基础上介绍 Django 中模板相关的用法。

视图中使用模板

from django.http import HttpResponse
from django.template import RequestContext, loader

from polls.models import Question

def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
    template = loader.get_template('polls/index.html')
    context = RequestContext(request, {
        'latest_question_list': latest_question_list,
    })
    return HttpResponse(template.render(context))

代码说明：

通过 loader 来加载模板页面，如前面提到的，这里是相对 polls/templates 目录
创建上下文，将需要传递到页面的变量放入上下文变量 context
使用 template 通过上下文来渲染页面

在 settings.py 中有一个 TEMPLATE_LOADERS 属性，并且有一个默认值 django.template.loaders.app_directories.Loader，该值定义了从每一个安装的 app 的 templates 目录下寻找模板。当然，你也可以编辑 settings.py 文件中的 TEMPLATE_DIRS属性手动指定模板路径：

TEMPLATE_DIRS = (
    # Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
    # Always use forward slashes, even on Windows.
    # Don't forget to use absolute paths, not relative paths.
    '/home/django/mysite/templates',
)

上面配置的是系统绝对路径，最好的方式是使用代码动态构建这个路径，例如：

import os

BASE_DIR = os.path.dirname(os.path.dirname(__file__))

TEMPLATE_DIRS = (
    os.path.join(BASE_DIR,'templates').replace('\\','/'),
)

这个例子使用了神奇的 Python 内部变量 __file__ ，该变量被自动设置为代码所在的 Python 模块文件名。 os.path.dirname(__file__)将会获取自身所在的文件，然后由 os.path.join 这个方法将这目录与 templates 进行连接。如果在 windows下，它会智能地选择正确的后向斜杠’/’进行连接，而不是前向斜杠’/’。

完成 TEMPLATE_DIRS 设置后，下一步就是修改视图代码，让它使用 Django 模板加载功能而不是对模板路径硬编码。

举例如下：

from django.template.loader import get_template
from django.template import Context
from django.http import HttpResponse
import datetime

def current_datetime(request):
    now = datetime.datetime.now()
    t = get_template('current_datetime.html')
    html = t.render(Context({'current_date': now}))
    return HttpResponse(html)

一种更加简洁的编码方式是使用 render_to_response()：

from django.shortcuts import render_to_response
import datetime

def current_datetime(request):
    now = datetime.datetime.now()
    return render_to_response('current_datetime.html', {'current_date': now})

上面两个方法都会传入 Context 上下文，将页面需要的变量传到前台去，如果变量很多，需要一一输入。还有一种更加简单的方式，那就是可以利用 Python 的内建函数locals() 。它返回的字典对所有局部变量的名称与值进行映射。因此，前面的视图可以重写成下面这个样子：

def current_datetime(request):
    current_date = datetime.datetime.now()
    return render_to_response('current_datetime.html', locals())

使用 locals() 时要注意是它将包括所有的局部变量，它们可能比你想让模板访问的要多。在前例中，locals() 还包含了 request。

模板标签

上面的例子中提到了模板 current_datetime.html ，其中的内容如何定义呢？这个就要使用模板标签了。Django 的模板系统带有内置的标签和过滤器。

if/else

if 标签检查一个变量，如果这个变量为真（即，变量存在，非空，不是布尔值假），系统会显示在 if 和 endif 之间的任何内容，例如：

{% if today_is_weekend %}
    <p>Welcome to the weekend</p>
{% endif %}

else 标签是可选的：

{% if today_is_weekend %}
    <p>Welcome to the weekend</p>
{% else %}
    <p>Get back to work.</p>
{% endif %}

一些注意事项：

if 标签接受 and ，or 或者 not 关键字来对多个变量做判断，或者对变量取反。

if 标签不允许在同一个标签中同时使用 and 和 or ，因为逻辑上可能模糊的。

系统不支持用圆括号来组合比较操作。

多次使用同一个逻辑操作符是没有问题的，但是我们不能把不同的操作符组合起来。

并没有 elif 标签，请使用嵌套的 if 标签来达成同样的效果。

一定要用 endif 关闭每一个 if 标签。

for

允许我们在一个序列上迭代。与 Python 的 for 语句的情形类似，循环语法是 for X in Y ，Y 是要迭代的序列而X是在每一个特定的循环中使用的变量名称。每一次循环中，模板系统会渲染在 for 和 endfor 之间的所有内容。

给定一个运动员列表 athlete_list 变量，我们可以使用下面的代码来显示这个列表：

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% endfor %}
</ul>

给标签增加一个 reversed 使得该列表被反向迭代：

{% for athlete in athlete_list reversed %}
        <li>{{ athlete.name }}</li>
{% endfor %}

在执行循环之前先检测列表的大小是一个通常的做法，当列表为空时输出一些特别的提示。

{% if athlete_list %}
    {% for athlete in athlete_list %}
        <p>{{ athlete.name }}</p>
    {% endfor %}
{% else %}
    <p>There are no athletes. Only computer programmers.</p>
{% endif %}

因为这种做法十分常见，所以 for 标签支持一个可选的 empty 分句，通过它我们可以定义当列表为空时的输出内容下面的例子与之前那个等价：

{% for athlete in athlete_list %}
    <p>{{ athlete.name }}</p>
{% empty %}
    <p>There are no athletes. Only computer programmers.</p>
{% endfor %}

Django不支持退出循环操作。

在每个 for 循环里有一个称为forloop 的模板变量。这个变量有一些提示循环进度信息的属性。

forloop.counter 总是一个表示当前循环的执行次数的整数计数器。这个计数器是从1开始的，所以在第一次循环时 forloop.counter 将会被设置为1。

{% for item in todo_list %}
    <p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}

forloop.counter0 类似于 forloop.counter ，但是它是从0计数的。第一次执行循环时这个变量会被设置为0。

forloop.revcounter 是表示循环中剩余项的整型变量。在循环初次执行时 forloop.revcounter 将被设置为序列中项的总数。最后一次循环执行中，这个变量将被置1。

forloop.revcounter0 类似于 forloop.revcounter ，但它以0做为结束索引。在第一次执行循环时，该变量会被置为序列的项的个数减1。

forloop.first 是一个布尔值，如果该迭代是第一次执行，那么它被置为 True

forloop.last 是一个布尔值；在最后一次执行循环时被置为True

forloop.parentloop 是一个指向当前循环的上一级循环的 forloop 对象的引用（在嵌套循环的情况下）

ifequal/ifnotequal

ifequal 标签比较两个值，当他们相等时，显示在 ifequal 和 endifequal 之中所有的值。参数可以是硬编码的字符串，随便用单引号或者双引号引起来。

{% ifequal user currentuser %}
    <h1>Welcome</h1>
{% endifequal %}

{% ifequal section "community" %}
    <h1>Community</h1>
{% endifequal %}

和 if 类似，ifequal 支持可选的 else 标签。

只有模板变量、字符串、整数和小数可以作为 ifequal 标签的参数。

cycle

每当我们使用一次这个标签后，标签中的值就会变化，如上，每使用一次下面的 cycle 标签，输出的就会在 row1 和 row2 之间切换。

{% for o in some_list %}  
    <tr class="{% cycle 'row1' 'row2' %}">  
        ...  
    </tr>  
{% endfor %}

一些情况下，我们希望将cycle当做一个变量一样来使用，那么我们可以这样：

<tr>  
    <td class="{% cycle 'row1' 'row2' as rowcolors %}">...</td>  
    <td class="{{ rowcolors }}">...</td>  
</tr>  
<tr>  
    <td class="{% cycle rowcolors %}">...</td>  
    <td class="{{ rowcolors }}">...</td>  
</tr>

最后，当出现我们不希望 cycle 主动输出的时候，也就是我么只希望它作为一个变量的时候，我们可以这样设置。

{% cycle 'row1' 'row2' as rowcolors silent %}

url

Django 中的 url 标签是用来简化 url 的定义，其可以通过唯一的名称引用 urls.py 中定义的 url。

例如：

urlpatterns = patterns('',    
    url(r'^hello/$', hello,name='hello'),
)

对于上面的定义，可以在模板里通过 hello 名称来应用 hello/ 这个 url。

<a href="{% url 'hello' %}">Hello World</a>

这样使用的好处是，无论你怎么修改 urlpatterns 的地址，Template 都会随着改变，省事了不少。在模版中调用url标签的时候，需要添加下面代码：

{% load url from future %}

需要注意的是：name是全局的，你整个 urlpatterns 里只能一个唯一的name。

如果想在试图中使用该名称，可以使用项目代码（关键在于 reverse 函数）：

from django.core.urlresolvers import reverse

HttpResponseRedirect(reverse("news_index"))

当遇到urlpatterns的地址包含有参数的时候，如：

(r'^(?P<year>\d{4})/(?P<month>\d{1,2})/$','news_list',name='news_archive' ),

有两个参数，最终的地址如归档的地址 http://blog.javachen.com/2014/10 ，这时候的标签使用如下：

<a href="{%url 'news_archive' 2014  10%}">2014年10月</a> 
<a href="{%url 'news_archive' year=2014  month=10%}">2014年10月</a>

当然，在你后台的 views.py 中的方法上也必须有这两个参数。

def news_list(request,year,month):
    print 'year:',year
    print 'monty:',month

而在试图里写法如下：

from django.core.urlresolvers import reverse
......
reverse("news_archive",kwargs={"year":2014,"month":10})

autoescape

控制HTML转义，参数是：on 或 off。效果和使用 safe 或 escape 过滤器相同。

{% autoescape on %}
    {{ body }}
{% endautoescape %}

csrf_token

防止跨站请求伪造。

<form action="." method="post">{% csrf_token %}

debug

输出完整的调试信息，包括当前的上下文及导入的模块信息。

filter

通过可变过滤器过滤变量的内容。

过滤器也可以相互传输，它们也可以有参数，就像变量的语法一样。

例：

{% filter force_escape|lower %}
    This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}

注意： escape 和safe 过滤器不能接受参数，而使用 autoescape 标签用来管理模板代码块的自动转移。

firstof

输出传入的第一个不是 False 的变量，如果被传递变量都是 False ，则什么也不输出。例：

{% firstof var1 var2 var3 %}

等价于:

{% if var1 %}
    {{ var1|safe }}
{% else %}{% if var2 %}
    {{ var2|safe }}
{% else %}{% if var3 %}
    {{ var3|safe }}
{% endif %}{% endif %}{% endif %}

extends

extends 标签声明这个模板继承的父模板。

例如：

{% extends "base.html" %}
{% load staticfiles %}

{% block css %} 
{{ block.super }}
<link href="{% static 'css/page/index.css' %}" rel="stylesheet" type="text/css"/>
{% endblock %}

{% block content %}
<p>Hello world</p>
{% include "partial/index/product_list.html" %}
{% endblock %}

上面代码中，首先用extends标签声明这个模板继承的父模板（必须保证其为模板中的第一个模板标记）。接着重定义 css 这个 block，在包含了父模板的基础上（block.super）引入了新的 CSS 文件；替换了 content 这个 block。这就是子模板所做的全部工作。

block

所有的 block 标签告诉模板引擎，子模板可以重载这些部分，如果子模板不重载这些部分，则将按默认的内容显示。例如：

{% load staticfiles %}
<!DOCTYPE html>
<head>
    <title>
        {% block title %} The Default Title {% endblock %}
    </title>

    {% block css %} 
    <link href="{% static 'css/base.css' %}" rel="stylesheet" type="text/css"/>
    {% endblock %}
</head>
<body>
    <div id="wrapper">
        {% block header %}
        {% include 'partial/header.html' %}
        {% endblock %}

        {% block content %} {% endblock %}

        {% block footer %}
        {% include 'partial/footer.html' %}
        {% endblock %}
    </div>

    {% block js %} 
    <script type="text/javascript" src="{% static 'js/jquery.min.js' %}"></script>
    {% endblock %}
</body>

顺便提一下，模板中的 load staticfiles 表示加载静态资源，这个一般用于加载 CSS、JS 等静态文件时用到

include

该标签允许在（模板中）包含其它的模板的内容。标签的参数是所要包含的模板名称，可以是一个变量，也可以是用单/双引号硬编码的字符串。每当在多个模板中出现相同的代码时，就应该考虑是否要使用 include 来减少重复，这也是为了提高代码的可重用性。

注释

注释使用：

{# This is a comment #}

如果要实现多行注释，可以使用 comment 模板标签。

过滤器

模板过滤器是在变量被显示前修改它的值的一个简单方法，过滤器使用管道字符，例如：

{{ name|lower }}

显示的内容是变量被过滤器 lower 处理后的结果，它功能是转换文本为小写。

过滤管道可以套接：

{{ my_list|first|upper }}

有些过滤器有参数。过滤器的参数跟随冒号之后并且总是以双引号包含。例如：

{{ bio|truncatewords:"30" }}

这个将显示变量 bio 的前30个词。

当我们使用了网页编辑器的时候，我们通过编辑器得到的是一串 HTML 代码，如果字节输出，那么 django 会将它默认输出为字符串，从而不能显示出样式。这时候，我们可以使用过滤器来实现我们想要的。

{{myHtml|safe}}

这样，我们的字符串就被当做 HTML 代码来输出了。safe 表示这段代码是安全的。

一些常见的过滤器：

addslashes：添加反斜杠到任何反斜杠、单引号或者双引号前面。这在处理包含 JavaScript 的文本时是非常有用的。
date：按指定的格式字符串参数格式化 date 或者 datetime 对象，范例：

{{ pub_date|date:"F j, Y" }}

Django中的模板

视图中使用模板

模板标签

if/else

for

ifequal/ifnotequal

cycle

url

autoescape

csrf_token

debug

filter

firstof

extends

block

include

注释

过滤器

热门文章

最新文章

相关课程

相关电子书

相关实验场景

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

Django中的模板

视图中使用模板

模板标签

if/else

for

ifequal/ifnotequal

cycle

url

autoescape

csrf_token

debug

filter

firstof

extends

block

include

注释

过滤器

热门文章

最新文章

相关课程

相关电子书

相关实验场景