在前面的几节中我们都是用简单的 django.http.HttpResponse 来把内容显示到网页上,本节将讲解如何使用渲染模板的方法来显示内容。


模板

网站模板的设计,一般的,我们做网站有一些通用的部分,比如 导航,底部,访问统计代码等等.
比如nav.html, bottom.html, tongji.html

可以写一个 base.html 来包含这些通用文件(include)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!DOCTYPE html>
<html>
<head>
<title>{% block title %}默认标题{% endblock %} - 自强学堂</title>
</head>
<body>
{% include 'nav.html' %}
{% block content %}
<div>这里是默认内容,所有继承自这个模板的,如果不覆盖就显示这里的默认内容。</div>
{% endblock %}
{% include 'bottom.html' %}
{% include 'tongji.html' %}
</body>
</html>

如果需要,写足够多的 block 以便继承的模板可以重写该部分,include 是包含其它文件的内容,就是把一些网页共用的部分拿出来,重复利用,改动的时候也方便一些,还可以把广告代码放在一个单独的html中,改动也方便一些,在用到的地方include进去。其它的页面继承自 base.html 就好了,继承后的模板也可以在 block 块中 include 其它的模板文件。

比如我们的首页 home.html,继承或者说扩展(extends)原来的 base.html,可以简单这样写,重写部分代码(默认值的那一部分不用改)

1
2
3
4
5
6
7
8
{% extends 'base.html' %}
{% block title %}欢迎光临首页{% endblock %}
{% block content %}
{% include 'ad.html' %}
这里是首页,欢迎光临
{% endblock %}

注意:模板一般放在app下的templates中,Django会自动去这个文件夹中找。但 假如我们每个app的templates中都有一个 index.html,当我们在views.py中使用的时候,直接写一个 render(request, ‘index.html’),Django 能不能找到当前 app 的 templates 文件夹中的 index.html 文件夹呢?(答案是不一定能,有可能找错

##Django 模板查找机制
Django 查找模板的过程是在每个 app 的 templates 文件夹中找(而不只是当前 app 中的代码只在当前的 app 的 templates 文件夹中找)。各个 app 的 templates 形成一个文件夹列表,Django 遍历这个列表,一个个文件夹进行查找,当在某一个文件夹找到的时候就停止,所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似于Python找包)。这样设计有利当然也有弊,有利是的地方是一个app可以用另一个app的模板文件,弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 app 同名的文件夹,这样就好了。

这样,使用的时候,模板就是 “blog/index.html” 和 “mmmwhy/index.html” 这样有app作为名称的一部分,就不会混淆。

Django 模板进阶

本节主要讲 Django模板中的循环,条件判断,常用的标签,过滤器的使用。

显示一个基本的字符串在网页上

  • views.py
    1
    2
    3
    def home(request):
    string = u"我是一个小胖子"
    return render(request, 'home.html', {'string': string})

在视图中我们传递了一个字符串名称是 string 到模板 home.html,在模板中这样使用它:

  • home.html
    1
    {{ string }}

基本的 for 循环 和 List内容的显示

  • views.py

    1
    2
    3
    def home(request):
    TutorialList = ["HTML", "CSS", "jQuery", "Python", "Django"]
    return render(request, 'home.html', {'TutorialList': TutorialList})
  • home.html

    1
    2
    3
    {% for i in TutorialList %}
    {{ i }}
    {% endfor %} #for 循环要有一个结束标记

显示字典中内容:

  • views.py

    1
    2
    3
    def home(request):
    info_dict = {'site': u'肥羊', 'content': u'小姿势'}
    return render(request, 'home.html', {'info_dict': info_dict})
  • home.html

    1
    站点:{{ info_dict.site }} 内容:{{ info_dict.content }}

或者可以遍历字典内容:

1
2
3
{% for key, value in info_dict.items %}
{{ key }}: {{ value }}
{% endfor %}

在模板进行 条件判断和 for 循环的详细操作:

  • views.py

    1
    2
    3
    def home(request):
    List = map(str, range(100))# 一个长度为100的 List
    return render(request, 'home.html', {'List': List})
  • home.html

    1
    2
    3
    {% for item in List %}
    {{ item }}{% if not forloop.last %},{% endif %}
    {% endfor %}

模板中 获取当前网址,当前用户等

  • 获取当前用户

    1
    2
    3
    4
    5
    {% if request.user.is_authenticated %}
    {{ request.user.username }},您好!
    {% else %}
    请登陆,这里放登陆链接
    {% endif %}
  • 获取当前网址

    1
    {{ request.path }}
  • 获取当前 GET 参数:

    1
    {{ request.GET.urlencode }}