Django的模板层简介

Posted paulwhw

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Django的模板层简介相关的知识，希望对你有一定的参考价值。

Django的模板层

如果我们想要利用视图函数返回一个页面，一种比较简单的方式是利用HttpResponse()方法返回一个含有html内容的字符串：
def current_datetime(request):
    now = datetime.datetime.now()
    html = "<html><body>It is now %s.</body></html>" % now
    return HttpResponse(html)
尽管这种方式可以十分方便的解释视图的工作方式，但是，直接将HTML硬编码到你的视图里却并不是一个好主意。原因如下：
1.对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。 站点设计的修改往往比底层 Python 代码的修改要频繁得多，因此如果可以在不进行 Python 代码修改的情况下变更设计，那将会方便得多。
2.Python 代码编写和 HTML 设计是两项不同的工作，大多数专业的网站开发环境都将他们分配给不同的人员（甚至不同部门）来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
3.程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的，远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。
基于上述原因，将页面的设计与Python代码分离开会干净简洁并且更易于维护。
因此，我们需要使用Django的模板系统(Template System)来实现这种设计模式。

Django的模板文件

简单的讲，Django的模板文件其实就是HTML代码与模板语法结合而成的一个“组合体”。
这里我们还以“返回当前时间”的需求为例，这次我们用模板文件去做，视图函数中的内容为(这里略去路由部分)：
def index(request):
    import datetime
    n = datetime.datetime.now()
    now = n.strftime(‘%Y-%m-%d %X‘)
    return render(request,‘index.html‘,{‘time_now‘:now})
模板文件index.html文件的内容为：
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<h4>当前时间:{{ time_now }}</h4>

</body>
</html>
这里render()方法渲染的模板文件是index.html，而往模板文件传的参数是time_now这个键对应的key值now。
模板文件index.html中除了我们熟悉的html标签以外，多了一个模板语法：{{ time_now }}。接下来为大家详细介绍下模板的语法。

Django的模板语法

变量

变量就是在Django模板中遍历复杂数据结构的句点字符，它的语法如下：{{ var_name }}
这里的var_name与视图函数中返回的render方法的第三个参数(字典)中的‘key‘值相对应。也就是说，模板文件接收的“参数”都是经过视图函数处理后传来的，而且视图函数可以将任何类型的数据(数字、字符串、列表、字典、对象、类等等)传给模板。
由于本文只讲解模板层的语法，因此下面的内容将路由控制与视图层的函数处理过程省略掉，但是建议大家在理解的时候尽量与路由控制与视图函数联系起来，因为这样有助于体会整个Django项目的“流程”。
变量的深度查询我们用句点符.来完成。比如我们想取列表ls下标为0的元素：{{ ls.0 }}
我们这里深入去研究变量的过滤器。所谓过滤器，其实就是对视图函数传来的值进行“加工”。过滤器的基本语法是：{{ obj|filter_name:param }}。其中obj为变量的名字；filter_name为某一个过滤器的名字；param是相应过滤器的参数。
各种常见的过滤器列举如下：
(1)date：如果views.py文件中传给模板的是一个“时间戳”，我们需要对这个时间进行格式化，具体语法是：{{n|date:‘Y-m-d‘}}。
(2)default：如果一个变量是false或者为空，则使用给定的默认值。否则，使用变量的值。例如：{{value|default:‘nothing‘}}。
(3)length：返回值的长度。它对字符串和列表都起作用。例如：{{value|length}}。
(4)slice：切片，假如value为一个字符串，找到它下标为2-5切片组成的新字符串：{{value|slice:‘2:5‘}}。
(5)truncatechars：如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾。参数是要截断的字符数。这里需要注意，结尾的‘...‘算三个字符，如果参数<=3，那浏览器上显示的永远是‘...‘:{{value|truncatechars:5}}。
(6)safe：Django的模板中会对HTML标签和JS等语法标签进行自动转义，原因显而易见，这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义，比如我们做一个内容管理系统，后台添加的文章中是经过修饰的，这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本，如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式，如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。比如views.py文件中的字符串是这样的：value="<a href="">点击</a>"那index.html中告诉浏览器正常渲染就行，最终得到的是一个a标签：{{value|safe}。

标签

标签的语法是这种结构：{% tag %}。标签比变量更加复杂：一些在输出中创建文本，一些通过循环或逻辑来控制流程，一些加载其后的变量将使用到的额外信息到模版中。一些标签需要开始和结束标签，例如：
{% tag %} 
...标签内容 ...
{% endtag %}
而标签的深度查询也跟变量一样，利用句点符来进行，这里主要介绍两种常见的标签：for标签与if标签。
(1)for标签：它的作用是遍历每一个元素。比如我们想遍历一个字典：
{% for key,value in dic.items %}
<p>{{key}}:{{value}}</p>
{% endfor %}
(1-1)循环期间的编号可以用{{ forloop }}显示，一下是forloop的说明：
forloop.counter            The current iteration of the loop (1-indexed)
forloop.counter0           The current iteration of the loop (0-indexed)
forloop.revcounter         The number of iterations from the end of the loop (1-indexed)
forloop.revcounter0        The number of iterations from the end of the loop (0-indexed)
forloop.first              True if this is the first time through the loop
forloop.last               True if this is the last time through the loop
例如我们想在遍历上面的字典时加上编号：
{% for key,value in dic.items %}
<p>{{forloop.counter0}}:{{key}}:{{value}}</p>
{% endfor %}
(1-2)for...empty：for标签带有一个可选的{% empty %} 从句，以便在给出的组是空的或者没有被找到时，可以有所操作。
{% for person in person_list %}
<p>{{ person.name }}</p>
{% empty %}
<p>sorry,no person here</p>
{% endfor %}
(2)if标签：{% if %}会对一个变量求值，如果它的值是“True”（存在、不为空、且不是boolean类型的false值），对应的内容块会输出。
{% if num > 100 or num < 0 %}
    <p>无效</p>
{% elif num > 80 and num < 100 %}
    <p>优秀</p>
{% else %}
    <p>凑活吧</p>
{% endif %}

继承

Django模版引擎中最强大也是最复杂的部分就是模版继承了。模版继承可以让您创建一个基本的“骨架”模版，它包含您站点中的全部元素并且可以定义能够被子模版覆盖的blocks 。
也就是说你，我们可以将重复的“骨架”写到一个base文件中，如果其它的文件都是基于这个骨架来写的，那么我们可以在这个骨架中在需要修改的地方用模板语法“标注”，以便可以让其它文件去替换它。
例如，我们在templates包中加入“骨架”文件base.html:
<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css" />
    <title>{% block title %}My amazing site{% endblock %}</title>
</head>

<body>
    <div id="sidebar">
        {% block sidebar %}
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
        {% endblock %}
    </div>

    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>
我们可以看到它定义了一个可以用于两列排版页面的简单HTML骨架。“子模版”的工作是用它们的内容填充空的blocks。在这个例子中，block标签定义了三个可以被子模版内容填充的block。blocks的作用是告诉模版引擎：子模版可能会覆盖掉模版中的这些位置。
我们将其中的一个字模板命名为base1.html，这里省略路由控制与视图函数中的内容，文件的内容是：
{% extends ‘base.html‘ %}
{% block title %} 哈哈哈哈 {% endblock %}
{% block content %}
    <p>{{ list_w }}</p>
{% endblock %}
extends标签是这里的关键。它告诉模版引擎，这个模版“继承”了另一个模版。当模版系统处理这个模版时：首先，它将定位父模版——在此例中，就是“base.html”;然后，模版引擎将注意到 base.html 中的三个 block 标签，并用子模版中的内容来替换这些block。
根据child1.html文件中的内容，最终的输出看起来是这样的：
<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css" />
    <title>哈哈哈哈</title>
</head>

<body>
    <div id="sidebar">
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
    </div>

    <div id="content">
        <p> [111,222,333]</p>
    </div>
</body>
</html>
这种方式使代码得到最大程度的复用，并且使得添加内容到共享的内容区域更加简单，例如，部分范围内的导航。但是需要注意的是，如果子模版并没有定义 sidebar block，所以系统最终会使用父模版中的值，也就是说，父模版的 {% block %} 标签中的内容总是被用作备选内容（fallback）。
关于继承，还有一下提示需要大家注意：
（1）如果你在模版中使用 {% extends %} 标签，它必须是模版中的第一个标签。其他的任何情况下，模版继承都将无法工作。
（2）在base模版中设置越多的 {% block %} 标签越好。请记住，子模版不必定义全部父模版中的blocks，所以，
     你可以在大多数blocks中填充合理的默认内容，然后，只定义你需要的那一个。多一点钩子总比少一点好。
（3）如果你发现你自己在大量的模版中复制内容，那可能意味着你应该把内容移动到父模版中的一个 {% block %} 中。
（4）为了更好的可读性，你也可以给你的{% endblock %} 标签一个 名字 。例如：
        {% block content %}
        ...
        {% endblock content %}
在大型模版中，这个方法帮你清楚的看到哪一个{% block %}标签被关闭了。         
（5）不能在一个模版中定义多个相同名字的block标签。

以上是关于Django的模板层简介的主要内容，如果未能解决你的问题，请参考以下文章

Django的模板层简介

DJANGO入门系列之(模板层)

Django之模板层

Django模板层

Django模板层

Django之模板层