Template基础

模板系统的介绍

你可能已经注意到我们在例子视图中返回文本的方式有点特别。也就是说，HTML被直接硬编码在 Python代码之中。

def current_datetime(request):

    now = datetime.datetime.now()

    html = "<html><body>It is now %s.</body></html>" % now

    return HttpResponse(html)

尽管这种技术便于解释视图是如何工作的，但直接将HTML硬编码到你的视图里却并不是一个好主意。让我们来看一下为什么：

对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。站点设计的修改往往比底层 Python 代码的修改要频繁得多，因此如果可以在不进行 Python 代码修改的情况下变更设计，那将会方便得多。

Python 代码编写和 HTML 设计是两项不同的工作，大多数专业的网站开发环境都将他们分配给不同的人员（甚至不同部门）来完成。设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。

程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的，远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。

基于这些原因，将页面的设计和Python的代码分离开会更干净简洁更容易维护。我们可以使用 Django的 模板系统 (Template System)来实现这种模式，这就是本章要具体讨论的问题。

------------------------------------------------------------------模板语法------------------------------------------------------------------

一模版的组成

组成：HTML代码＋逻辑控制代码

二逻辑控制代码的组成

1 变量（使用双大括号来引用变量）：

语法格式：       {{var_name}}

Template和Context对象

>>> python manange.py shell  (进入该django项目的环境)

>>> from django.template import Context, Template

>>> t = Template('My name is {{ name }}.')

>>> c = Context({'name': 'Stephane'})

>>> t.render(c)

'My name is Stephane.'

# 同一模板，多个上下文，一旦有了模板对象，你就可以通过它渲染多个context，无论何时我们都可以

# 像这样使用同一模板源渲染多个context，只进行 一次模板创建然后多次调用render()方法渲染会

# 更为高效：

# Low

for name in ('John', 'Julie', 'Pat'):

    t = Template('Hello, {{ name }}')

    print t.render(Context({'name': name}))

# Good

t = Template('Hello, {{ name }}')

for name in ('John', 'Julie', 'Pat'):

    print t.render(Context({'name': name}))

Django 模板解析非常快捷。大部分的解析工作都是在后台通过对简短正则表达式一次性调用来完成。这和基于 XML 的模板引擎形成鲜明对比，那些引擎承担了 XML 解析器的开销，且往往比 Django 模板渲染引擎要慢上几个数量级。

from django.shortcuts import render,HttpResponse

from django.template.loader import get_template #记得导入

# Create your views here.

import datetime

from django.template import Template,Context

# def current_time(req):

    #原始的视图函数

    # now=datetime.datetime.now()

    # html="<html><body>现在时刻：<h1>%s.</h1></body></html>" %now

    # return HttpResponse(html)

# def current_time(req):

      #django模板修改的视图函数

#     now=datetime.datetime.now()

#     t=Template('<html><body>现在时刻是:<h1 style="color:red">{{current_date}}</h1></body></html>')

      #t=get_template('current_datetime.html')

#     c=Context({'current_date':now})

#     html=t.render(c)

#     return HttpResponse(html)

#另一种写法(推荐)

def current_time(req):

    now=datetime.datetime.now()

    return render(req, 'current_datetime.html', {'current_date':now})

推荐方法

－－－－－－深度变量的查找（万能的句点号）

在到目前为止的例子中，我们通过 context 传递的简单参数值主要是字符串，然而，模板系统能够非常简洁地处理更加复杂的数据结构，例如list、dictionary和自定义的对象。

在 Django 模板中遍历复杂数据结构的关键是句点字符 (.)。

#最好是用几个例子来说明一下。

# 首先，句点可用于访问列表索引，例如：

>>> from django.template import Template, Context

>>> t = Template('Item 2 is {{ items.2 }}.')

>>> c = Context({'items': ['apples', 'bananas', 'carrots']})

>>> t.render(c)

'Item 2 is carrots.'

#假设你要向模板传递一个 Python 字典。 要通过字典键访问该字典的值，可使用一个句点：

>>> from django.template import Template, Context

>>> person = {'name': 'Sally', 'age': ''}

>>> t = Template('{{ person.name }} is {{ person.age }} years old.')

>>> c = Context({'person': person})

>>> t.render(c)

'Sally is 43 years old.'

#同样，也可以通过句点来访问对象的属性。 比方说， Python 的 datetime.date 对象有

#year 、 month 和 day 几个属性，你同样可以在模板中使用句点来访问这些属性：

>>> from django.template import Template, Context

>>> import datetime

>>> d = datetime.date(1993, 5, 2)

>>> d.year

1993

>>> d.month

5

>>> d.day

2

>>> t = Template('The month is {{ date.month }} and the year is {{ date.year }}.')

>>> c = Context({'date': d})

>>> t.render(c)

'The month is 5 and the year is 1993.'

# 这个例子使用了一个自定义的类，演示了通过实例变量加一点(dots)来访问它的属性，这个方法适

# 用于任意的对象。

>>> from django.template import Template, Context

>>> class Person(object):

...     def __init__(self, first_name, last_name):

...         self.first_name, self.last_name = first_name, last_name

>>> t = Template('Hello, {{ person.first_name }} {{ person.last_name }}.')

>>> c = Context({'person': Person('John', 'Smith')})

>>> t.render(c)

'Hello, John Smith.'

# 点语法也可以用来引用对象的方法。 例如，每个 Python 字符串都有 upper() 和 isdigit()

# 方法，你在模板中可以使用同样的句点语法来调用它们：

>>> from django.template import Template, Context

>>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}')

>>> t.render(Context({'var': 'hello'}))

'hello -- HELLO -- False'

>>> t.render(Context({'var': ''}))

'123 -- 123 -- True'

# 注意这里调用方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数；你只能调用不需参数的

# 方法。

－－－－－－变量的过滤器(filter)的使用

语法格式：      {{obj|filter:param}}

# 1  add          ：   给变量加上相应的值

   #

   # 2  addslashes   :    给变量中的引号前加上斜线

   #

   # 3  capfirst     :    首字母大写

   #

   # 4  cut          ：   从字符串中移除指定的字符

   #

   # 5  date         ：   格式化日期字符串

   #

   # 6  default      ：   如果值是False,就替换成设置的默认值，否则就是用本来的值

   #

   # 7  default_if_none:  如果值是None，就替换成设置的默认值，否则就使用本来的值

#实例:

#value1="aBcDe"

{{ value1|upper }}<br>

#value2=5

{{ value2|add:3 }}<br>

#value3='he  llo wo r ld'

{{ value3|cut:' ' }}<br>

#import datetime

#value4=datetime.datetime.now()

{{ value4|date:'Y-m-d' }}<br>

#value5=[]

{{ value5|default:'空的' }}<br>

#value6='<a href="#">跳转</a>'

{{ value6 }}

{% autoescape off %}

  {{ value6 }}

{% endautoescape %}

{{ value6|safe }}<br>

{{ value6|striptags }}

#value7='1234'

{{ value7|filesizeformat }}<br>

{{ value7|first }}<br>

{{ value7|length }}<br>

{{ value7|slice:":-1" }}<br>

#value8='http://www.baidu.com/?a=1&b=3'

{{ value8|urlencode }}<br>

    value9='hello I am yuan'

2 标签(tag)的使用（使用大括号和百分比的组合来表示使用tag）

语法格式：{% tags %}

－－－－－－{% if %} 的使用

{% if %}标签计算一个变量值，如果是“true”，即它存在、不为空并且不是false的boolean值,系统则会显示{% if %}和{% endif %}间的所有内容

复制代码

{% if num >= 100 and 8 %}

    {% if num > 200 %}

        <p>num大于200</p>

    {% else %}

        <p>num大于100小于200</p>

    {% endif %}

{% elif num < 100%}

    <p>num小于100</p>

{% else %}

    <p>num等于100</p>

{% endif %}

{% if %} 标签接受and，or或者not来测试多个变量值或者否定一个给定的变量

{% if %} 标签不允许同一标签里同时出现and和or，否则逻辑容易产生歧义，例如下面的标签是不合法的：

{% if obj1 and obj2 or obj3 %}

－－－－－－{% for %}的使用

{% for %}标签允许你按顺序遍历一个序列中的各个元素,每次循环模板系统都会渲染{% for %}和{% endfor %}之间的所有内容

<ul>

{% for obj in list %}

    <li>{{ obj.name }}</li>

{% endfor %}

</ul>

#在标签里添加reversed来反序循环列表：

    {% for obj in list reversed %}

    ...

    {% endfor %}

#{% for %}标签可以嵌套：

    {% for country in countries %}

        <h1>{{ country.name }}</h1>

        <ul>

         {% for city in country.city_list %}

            <li>{{ city }}</li>

         {% endfor %}

        </ul>

    {% endfor %}

#系统不支持中断循环，系统也不支持continue语句，{% for %}标签内置了一个forloop模板变量，

#这个变量含有一些属性可以提供给你一些关于循环的信息

1，forloop.counter表示循环的次数，它从1开始计数，第一次循环设为1:

    {% for item in todo_list %}

        <p>{{ forloop.counter }}: {{ item }}</p>

    {% endfor %}

2，forloop.counter0 类似于forloop.counter，但它是从0开始计数，第一次循环设为0

3，forloop.revcounter

4，forloop.revcounter0

5，forloop.first当第一次循环时值为True，在特别情况下很有用：

    {% for object in objects %}

         {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}

         {{ object }}

        </li>

    {% endfor %}  

# 富有魔力的forloop变量只能在循环中得到，当模板解析器到达{% endfor %}时forloop就消失了

# 如果你的模板context已经包含一个叫forloop的变量，Django会用{% for %}标签替代它

# Django会在for标签的块中覆盖你定义的forloop变量的值

# 在其他非循环的地方，你的forloop变量仍然可用

#{% empty %}

{{li }}

      {%  for i in li %}

          <li>{{ forloop.counter0 }}----{{ i }}</li>

      {% empty %}

          <li>this is empty!</li>

      {% endfor %}

#         [11, 22, 33, 44, 55]

#            0----11

#            1----22

#            2----33

#            3----44

#            4----55

－－－－－－{%csrf_token%}：csrf_token标签

用于生成csrf_token的标签，用于防治跨站攻击验证。注意如果你在view的index里用的是render_to_response方法，不会生效

其实，这里是会生成一个input标签，和其他表单标签一起提交给后台的。

－－－－－－{% url %}: 引用路由配置的地址

<form action="{% url "bieming"%}" >

          <input type="text">

          <input type="submit"value="提交">

          {%csrf_token%}

</form>

－－－－－－{% with %}:用更简单的变量名替代复杂的变量名

{% with total=fhjsaldfhjsdfhlasdfhljsdal %} {{ total }} {% endwith %}

－－－－－－{% verbatim %}: 禁止render

{% verbatim %}

         {{ hello }}

{% endverbatim %}

－－－－－－{% load %}: 加载标签库

3 自定义filter和simple_tag

－－－－－－a、在app中创建templatetags模块(必须的)

－－－－－－b、创建任意 .py 文件，如：my_tags.py

from django import template

from django.utils.safestring import mark_safe

register = template.Library()   #register的名字是固定的,不可改变

@register.filter

def filter_multi(v1,v2):

    return  v1 * v2

@register.simple_tag

def simple_tag_multi(v1,v2):

    return  v1 * v2

@register.simple_tag

def my_input(id,arg):

    result = "<input type='text' id='%s' class='%s' />" %(id,arg,)

    return mark_safe(result)

－－－－－－c、在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py ：{% load my_tags %}

－－－－－－d、使用simple_tag和filter（如何调用）

-------------------------------.html

{% load xxx %}   #首行

 # num=12

{{ num|filter_multi:2 }} #

{{ num|filter_multi:"[22,333,4444]" }}

{% simple_tag_multi 2 5 %}  参数不限,但不能放在if for语句中

{% simple_tag_multi num 5 %}

－－－－－－e、在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.

注意：

filter可以用在if等语句后，simple_tag不可以

{% if num|filter_multi:30 > 100 %}

    {{ num|filter_multi:30 }}

{% endif %}

4 extend模板继承

－－－－－－include 模板标签

在讲解了模板加载机制之后，我们再介绍一个利用该机制的内建模板标签： {% include %} 。该标签允许在（模板中）包含其它的模板的内容。标签的参数是所要包含的模板名称，可以是一个变量，也可以是用单/双引号硬编码的字符串。每当在多个模板中出现相同的代码时，就应该考虑是否要使用 {% include %} 来减少重复。

－－－－－－extend(继承)模板标签

到目前为止，我们的模板范例都只是些零星的 HTML 片段，但在实际应用中，你将用 Django 模板系统来创建整个 HTML 页面。这就带来一个常见的 Web 开发问题：在整个网站中，如何减少共用页面区域（比如站点导航）所引起的重复和冗余代码？

解决该问题的传统做法是使用 服务器端的 includes ，你可以在 HTML 页面中使用该指令将一个网页嵌入到另一个中。事实上， Django 通过刚才讲述的 {% include %} 支持了这种方法。但是用 Django 解决此类问题的首选方法是使用更加优雅的策略—— 模板继承 。

本质上来说，模板继承就是先构造一个基础框架模板，而后在其子模板中对它所包含站点公用部分和定义块进行重载。

让我们通过修改 current_datetime.html 文件，为 current_datetime 创建一个更加完整的模板来体会一下这种做法：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html lang="en">

<head>

    <title>The current time</title>

</head>

<body>

    <h1>My helpful timestamp site</h1>

    <p>It is now {{ current_date }}.</p>

    <hr>

    <p>Thanks for visiting my site.</p>

</body>

</html>

这看起来很棒，但如果我们要为 hours_ahead 视图创建另一个模板会发生什么事情呢？

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html lang="en">

<head>

    <title>Future time</title>

</head>

<body>

    <h1>My helpful timestamp site</h1>

    <p>In {{ hour_offset }} hour(s), it will be {{ next_time }}.</p>

    <hr>

    <p>Thanks for visiting my site.</p>

</body>

</html>

很明显，我们刚才重复了大量的 HTML 代码。想象一下，如果有一个更典型的网站，它有导航条、样式表，可能还有一些 JavaScript 代码，事情必将以向每个模板填充各种冗余的 HTML 而告终。

解决这个问题的服务器端 include 方案是找出两个模板中的共同部分，将其保存为不同的模板片段，然后在每个模板中进行 include。也许你会把模板头部的一些代码保存为 header.html 文件：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html lang="en">

<head>

你可能会把底部保存到文件 footer.html :

<hr>

    <p>Thanks for visiting my site.</p>

</body>

</html>

对基于 include 的策略，头部和底部的包含很简单。麻烦的是中间部分。在此范例中，每个页面都有一个<h1>My helpful timestamp site</h1> 标题，但是这个标题不能放在 header.html 中，因为每个页面的 <title> 是不同的。如果我们将 <h1> 包含在头部，我们就不得不包含 <title> ，但这样又不允许在每个页面对它进行定制。何去何从呢？

Django 的模板继承系统解决了这些问题。你可以将其视为服务器端 include 的逆向思维版本。你可以对那些不同的代码段进行定义，而不是共同代码段。

第一步是定义基础模板,该框架之后将由子模板所继承。以下是我们目前所讲述范例的基础模板：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html lang="en">

<head>

    <title>{% block title %}{% endblock %}</title>

</head>

<body>

    <h1>My helpful timestamp site</h1>

    {% block content %}{% endblock %}

    {% block footer %}

    <hr>

    <p>Thanks for visiting my site.</p>

    {% endblock %}

</body>

</html>

这个叫做 base.html 的模板定义了一个简单的 HTML 框架文档，我们将在本站点的所有页面中使用。子模板的作用就是重载、添加或保留那些块的内容。（如果你一直按顺序学习到这里，保存这个文件到你的template目录下，命名为 base.html .）

我们使用模板标签： {% block %} 。所有的 {% block %} 标签告诉模板引擎，子模板可以重载这些部分。每个{% block %}标签所要做的是告诉模板引擎，该模板下的这一块内容将有可能被子模板覆盖。

现在我们已经有了一个基本模板，我们可以修改 current_datetime.html 模板来使用它：

{% extends "base.html" %}

{% block title %}The current time{% endblock %}

{% block content %}

<p>It is now {{ current_date }}.</p>

{% endblock %}

再为 hours_ahead 视图创建一个模板，看起来是这样的：

{% extends "base.html" %}

{% block title %}Future time{% endblock %}

{% block content %}

<p>In {{ hour_offset }} hour(s), it will be {{ next_time }}.</p>

{% endblock %}

看起来很漂亮是不是？每个模板只包含对自己而言 独一无二 的代码。无需多余的部分。如果想进行站点级的设计修改，仅需修改 base.html ，所有其它模板会立即反映出所作修改。

以下是其工作方式：

在加载 current_datetime.html 模板时，模板引擎发现了 {% extends %} 标签，注意到该模板是一个子模板。模板引擎立即装载其父模板，即本例中的 base.html 。此时，模板引擎注意到 base.html 中的三个 {% block %} 标签，并用子模板的内容替换这些 block 。因此，引擎将会使用我们在 { block title %} 中定义的标题，对 {% block content %} 也是如此。所以，网页标题一块将由{% block title %}替换，同样地，网页的内容一块将由 {% block content %}替换。

注意由于子模板并没有定义 footer 块，模板系统将使用在父模板中定义的值。父模板 {% block %} 标签中的内容总是被当作一条退路。继承并不会影响到模板的上下文。换句话说，任何处在继承树上的模板都可以访问到你传到模板中的每一个模板变量。你可以根据需要使用任意多的继承次数。使用继承的一种常见方式是下面的三层法：

   <1> 创建 base.html 模板，在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。

   <2> 为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。这些模板对base.html 进行拓展，
       并包含区域特定的风格与设计。

   <3> 为每种类型的页面创建独立的模板，例如论坛页面或者图片库。 这些模板拓展相应的区域模板。

这个方法可最大限度地重用代码，并使得向公共区域（如区域级的导航）添加内容成为一件轻松的工作。

以下是使用模板继承的一些诀窍：

<1>如果在模板中使用 {% extends %} ，必须保证其为模板中的第一个模板标记。 否则，模板继承将不起作用。

 <2>一般来说，基础模板中的 {% block %} 标签越多越好。 记住，子模板不必定义父模板中所有的代码块，因此

    你可以用合理的缺省值对一些代码块进行填充，然后只对子模板所需的代码块进行（重）定义。 俗话说，钩子越

    多越好。

 <3>如果发觉自己在多个模板之间拷贝代码，你应该考虑将该代码段放置到父模板的某个 {% block %} 中。

    如果你需要访问父模板中的块的内容，使用 {{ block.super }}这个标签吧，这一个魔法变量将会表现出父模

    板中的内容。 如果只想在上级代码块基础上添加内容，而不是全部重载，该变量就显得非常有用了。

 <4>不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。

    也就是说，block 标签不仅挖了一个要填的坑，也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个

    相同名称的 {% block %} 标签，父模板将无从得知要使用哪个块的内容。

诀窍

Template基础的更多相关文章

Template 基础篇-函数模板（待看
Template 基础篇-函数模板 Template所代表的泛型编程是C++语言中的重要的组成部分,我将通过几篇blog对这半年以来的学习做一个系统的总结,本文是基础篇的第一部分. Template ...
django1&period;6之template基础用法
>>> settings.configure()>>> tem=template.Template("my template is {{name}}&qu ...
Python：Day53 Template基础
一.模板由 html代码+逻辑控制代码组成二.逻辑控制代码的组成 1.变量(使用双大括号来引用变量) 语法格式:{{ var_name }} -----------------------Temp ...
iview admin template 基础模板架子
https://github.com/iview/iview-admin/tree/template
C++template基础
函数模板类模板参数魔法模板与友元
Django基础之安装配置
安装配置一 MVC和MTV模式著名的MVC模式:所谓MVC就是把web应用分为模型(M),控制器(C),视图(V)三层:他们之间以一种插件似的,松耦合的方式连接在一起. 模型负责业务对象与数据库的 ...
【Django】--基础知识
一什么是web框架? 框架,即framework,特指为解决一个开放性问题而设计的具有一定约束性的支撑结构,使用框架可以帮你快速开发特定的系统,简单地说,就是你用别人搭建好的舞台来做表演. Web应 ...
Django知识点整理
什么是web框架框架,即framework,特指为解决一个开放性问题而设计的具有一定约束性的支撑结构,使用框架可以帮你快速开发特定的系统,简单地说,就是你用别人搭建好的舞台来做表演. web应用访 ...
django--主要部分
django URL URL配置(URLconf)就像Django 所支撑网站的目录.它的本质是URL模式以及要为该URL模式调用的视图函数之间的映射表:你就是以这种方式告诉Django,对于这个U ...

随机推荐

Bloom Filter 概念和原理
Bloom filter 是由 Howard Bloom 在 1970 年提出的二进制向量数据结构,它具有很好的空间和时间效率,被用来检测一个元素是不是集合中的一个成员.如果检测结果为是,该元素不一定 ...
TCP &amp&semi; UDP 的区别
一.概念 ① TCP(Transmission Control Protocol 传输控制协议)是一种面向连接的.可靠的.基于字节流的传输层通信协议. “面向连接”就是在正式通信前必须要与对方建立起连 ...
UVa 11292 The Dragon of Loowater 勇者斗恶龙
你的王国里有一条n个头的恶龙,你希望雇佣一些骑士把它杀死(也就是砍掉所有的头).村里有m个骑士可以雇佣,一个能力值为 x 的骑士可以砍掉恶龙一个直径不超过 x 的头,且需要支付 x 个金币.如何雇佣骑 ...
增强Eclipse ，MyEclipse 的代码自动提示功能
一般默认情况下,Eclipse ,MyEclipse 的代码提示功能是比Microsoft Visual Studio的差很多的,主要是Eclipse ,MyEclipse本身有很多选项是默认关闭的, ...
Java基础知识强化49：10个实用的但偏执的Java编程技术
1. 将String字符串放在最前面为了防止偶发性的NullPointerException 异常,我们通常将String放置在equals()函数的左边来实现字符串比较,如下代码: // Bad ...
小程序采坑系列-this&period;setData
今天踩了大坑,坑里还都是碎瓶渣子.. 先说一下基本使用.官网也有. 比如说你在main.js里面有这些变量.想修改某些值. data: { main_view_bgcolor: "&quot ...
6/4 sprint2 看板和燃尽图的更新
ubuntu 14&period;04/14&period;10 iptables 防火墙设置
1. 一键批处理设置 [plain] view plaincopyprint? #!/bin/bash PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/loc ...
fopen&lowbar;s()
原型:errno_t fopen_s( FILE** pFile, const char *filename, const char *mode ); 例子: char *filePath=&q ...
Java程序的结构和执行
目录 Java程序的结构 Java程序的执行 source code -- compiler -- class file -- JVM compiler JVM Java语法数据类型数据的存储堆 ...