首页投稿（暂停使用，暂停投稿）程序员

Django模板系统使用指南

2017-06-27  本文已影响591人  煮茶忘放糖

Django自带的模板系统虽然比不上专业的类似jinjia2那么自由的模板系统，但是对于我们新手来说也是够用了，由于Django是一个强大且全面的大型Web框架，该有的都已经内置了，功能上不尽完美也有替代的方案，所以以后有机会再和大家说说如何替换默认自带模板系统。

今天我们来聊一聊Django模板系统使用的方法，我尽量全面且系统的介绍使用方法，如果有遗漏或欠缺的地方，麻烦指正。

1.语句语法的使用

1.1 静态文件引用：

<!--页头-->
{% load staticfiles %}

<!--使用-->
{% static "文件路径" %}

1.2 相对地址引用：

{% url '应用名称:url.py内定义的名字'  %}

注意：名称后面可跟着参数，传值方式为位置传参（value1,value2）和关键词传参（value="1"）。

1.3 变量或常量传递：

例如：我想根据网页内容的不同显示不同的标题。
做法：

# views.py
# -*- coding: utf-8 -*-
from django.shortcuts import render
 
def index(request):
    title = "标题1"
    return render(request, 'index.html', {'title ': title })

使用：

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{{title}}</title>
</head>
<body>
    <h1>我的第一个HTML页面</h1>
    <p>我的第一个段落。</p>
</body>
</html>

而如果是字典呢？

# views.py
# -*- coding: utf-8 -*-
from django.shortcuts import render
 
def index(request):
    test_dict = {'name': '测试字典类型', 'content': '简单示例'}
    return render(request, 'index.html', {'test_dict': test_dict})

使用（在模板中取字典的键是用 **. **(例如：test_dict.name)，而不是我们认为的Python中的 test_dict['name']）：

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>网站标题</title>
</head>
<body>
    <h1>{{ test_dict.name }}</h1>
    <p>{{ test_dict.content}}</p>
</body>
</html>

特别注意：所有用到上下文传递的数据只能是字典类型，模板系统并不支持下标索引。

1.4 自定义模板标签：

说明：本段参考《 追梦人物：10 - 页面侧边栏：使用自定义模板标签 》

有时候我们需要使用一些公共的数据，而如果每次都在视图内写获取函数，那会导致我们写很多重复代码，所以Django为我们提供了自定义模板标签。

简单示例：

首先在我们的项目应用下创建一个 templatetags 文件夹。然后在这个文件夹下创建一个** __init__.py**文件，使这个文件夹成为一个 Python 包，之后在 templatetags\ 目录下创建一个 get_data.py 文件，这个文件存放自定义的模板标签代码。

# get_data.py
from django import template

register = template.Library()

@register.simple_tag
def get_data_age():
    age = 10
    return age

使用：

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>网站标题</title>
</head>
<body>
<!--导入自定义模板标签-->
{% load get_data %}
<!--将函数获取的值取名-->
{% get_data_age as age%}
    <h1>我的第一个HTML页面</h1>
        <!--使用-->
    <p>我的年纪{{ age }}</p>
</body>
</html>

说明：这里我们首先导入 template 这个模块，然后实例化了一个 template.Library 类，并将函数 get_recent_posts 装饰为 register.simple_tag。这样就可以在模板中使用语法 {% get_data_age %} 调用这个函数了。

注意： Django 1.9 后才支持 simple_tag 模板标签，如果你使用的 Django 版本小于 1.9，你将得到一个错误。

2.通用模板的使用

很多网站的网页会存在公共部分（即相同标签内容，比如导航，底部等），所以Django将这部分内容做成block，减轻我们的工作量。

2.1 简单使用方法：

首先在你的其他html文件同级目录下新建一个html文件，名称自定义，最好与公用部分含义一致，例如：test.html，下面我以这个名称做示例。

完整的HTML页面比如是这样的：

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>网站标题</title>
</head>
<body>
    <h1>我的第一个HTML页面</h1>
    <p>我的第一个段落。</p>
</body>
</html>

我们把公共部分抽离出来，不同页面不同部分做成block：

提示：其中name为自定义名称。

<!--test.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>网站标题</title>
</head>
<body>
    {% block name %}
    {% endblock name %}
</body>
</html>

然后我们就可以修改index.html的内容：

<!--index.html-->
{% extends 'test.html' %}
    {% block name %}
    {% endblock name %}

注意：“ Django 模板查找机制： Django 查找模板的过程是在每个 的 **templates **文件夹中找（而不只是当前应用 中的代码只在当前的应用的 templates 文件夹中找）。各个应用的 templates 形成一个文件夹列表，Django 遍历这个列表，一个个文件夹进行查找，当在某一个文件夹找到的时候就停止，所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found （过程类似于Python找包）。这样设计有利当然也有弊，有利是的地方是一个应用可以用另一个应用的模板文件，弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 应用同名的文件夹，这样就好了。” -- 来自 《自强学堂-Django基础教程》

还有一个全内容引用：
{% include 'test1.html' %} ：代表导入test1.html内所有内容到指定位置（可重复使用）。

3.逻辑控制的语法

3.1 if else 条件判断：

注意：这里的if语句并没有elif。

{% if 真/假 %}
  执行语句一 
{% else %}
  否则执行语句二
{% endif%}

3.2 for in 循环遍历：

{% for 值 in 可迭代对象 %}
  执行语句一 
{% empty %}
  值为空时执行的语句
{% endfor%}

3.2.1 for in 循环内的控制变量

例如：

{% for item in items%}
    {{ item }}{% if not forloop.last %}如果此次循环item为最后一个值，则item后面加上本段文字{% endif %} 
{% endfor %}

其他更多用法自己实验。

3.3 ifequal/ifnotequal 值判断是否相同：

注意：{% ifequal %}比较两个值，如果相等，则显示{% ifequal %}和{% endifequal %}之间的所有内容：
{% ifnotequal%} 自然就是不相等了。

{% ifequal 值1 值2%}
  执行语句一 
{% else %}
  否则执行语句二
{% endifequal %}

4.基础的模板过滤

... 欢迎补充完善。

5.涉及的其他知识

5.1 自定义过滤器：

其实这里和之前1.4的自定义模板标签差不多，都是定义一个函数：

例如：这里我定义一个获取传入值前5位字符的过滤器

做法：同样是那个get_data.py文件

# get_data.py
from django import template

register = template.Library()

@register.filter(name='truncate_filter')
def truncate_chars(value):
    if value.__len__() > 5:
        return '%s......'% value[0:5]
    else:
        return value

如果没有使用name参数，django默认会将函数名作为name参数的值，所以下面的代码和上面的代码作用相同。

# get_data.py
from django import template

register = template.Library()

@register.filter
def truncate_chars(value):
    if value.__len__() > 5:
        return '%s......'% value[0:5]
    else:
        return value

说明：Library.filter(name,function,is_safe=False,needs_autoescape=False,excepts_localtime=False)函数默认需要两个参数，name是装饰器的名称(字符串类型)，function是函数名。

后面三个参数可以参考 官方文档。这部分内容过于繁杂，一篇文章可能说不完，我暂时也并没有用到，所以不做过多阐述。

用法：

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>网站标题</title>
</head>
<body>
<!--导入自定义模板标签-->
{% load get_data %}
    <h1>我的第一个HTML页面</h1>
        <!--使用-->
    <p>我的年纪{{ "123456789"|truncate_chars}}</p>
</body>
</html>

这里只是做一个示例，你自己可以定义更强大的过滤器，毕竟我们缺少的只是想象力。

end

上一篇下一篇

猜你喜欢

热点阅读