Django之模板层的实现代码

在例子视图中返回文本的方式有点特别,即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)来是现在这种模式,这就是本章要具体讨论的问题。

Python的模板:HTML代码 + 模板语法

def current_time(req):
  # ================================原始的视图函数
  # import datetime
  # now=datetime.datetime.now()
  # html="<html><body>现在时刻:<h1>%s.</h1></body></html>" %now

  # ================================django模板修改的视图函数
  # from django.template import Template,Context
  # now=datetime.datetime.now()
  # t=Template('<html><body>现在时刻是:<h1>{{current_date}}</h1></body></html>')
  # #t=get_template('current_datetime.html')
  # c=Context({'current_date':str(now)})
  # html=t.render(c)
  #
  # return HttpResponse(html)

  #另一种写法(推荐)
  import datetime
  now=datetime.datetime.now()
  return render(req, 'current_datetime.html', {'current_date':str(now)[:19]})

一、模板语法之变量

在Django模板中遍历复杂数据结构的关键是句点字符,语法:

{{var_name}}

views.py:

def index(request):
  import datetime
  s="hello"
  l=[111,222,333]  # 列表
  dic={"name":"yuan","age":18} # 字典
  date = datetime.date(1993, 5, 2)  # 日期对象

  class Person(object):
    def __init__(self,name):
      self.name=name

  person_yuan=Person("yuan") # 自定义类对象
  person_egon=Person("egon")
  person_alex=Person("alex")

  person_list=[person_yuan,person_egon,person_alex]

   return render(request,"index.html",{"l":l,"dic":dic,"date":date,"person_list":person_list})

template:

<h4>{{s}}</h4>
<h4>列表:{{ l.0 }}</h4>
<h4>列表:{{ l.2 }}</h4>
<h4>字典:{{ dic.name }}</h4>
<h4>日期:{{ date.year }}</h4>
<h4>类对象列表:{{ person_list.0.name }}</h4>
注:句点符也可以用来引用对象的方法(无参数方法):
<h4>字典:{{ dic.name.upper }}</h4>

二、模板之过滤器

语法:

{{obj|filter_name:param}}

default

如果一个变量是False后者为空,使用给定的默认值。否则,使用变量的值。例如:

{{ value|default:'nothing' }}

length

返回值的长度。它对字符串和列表都起作用。例如:

{{ value|length }}

如果value是 ['a', 'b', 'c', 'd'] ,那么输出的就是4.

filesizeformat

将值格式化为一个 “人类可读的” 文件尺寸 (例如 '13 KB' , '4.1 MB' , '102 bytes' , 等等)。例如:

{{ value|filesizeformat }}

如果value = 123456789,输出将会是117.7 MB。

date

如果value = datetime.datetime.now()

{{ value|date:"Y-m-d" }}

slice

如果value = "hello world"

{{ value|slice:"2:-1" }}

truncatechars

如果字符串字符多于指定的字符数量,那么会被截断。截断的字符串将以可翻译的省略号序列("...")结尾。

参数:要截断的字符数

{{ value|truncatechars:9 }}

safe

Django的模板中会对HTML标签和JS语法等标签进行自动转义,原因显而易见这样是为了安全。但是有时候我们可能不希望这些HTML元素被转义,比如我们做一个内容管理系统,后他添加的文章中是经过修饰的,这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本,如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式,如果是一个单独的变量我们可以通过过滤器"|safe"的方式告诉Django这段代码是安全的不必转义。比如:

value = "<a href=''>点击</a>"
{{ value|safe }}

三、模板之标签

标签看起来像是这样: {% tag %} 。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息的模板中。一些标签需要开开始和结束标签(例如 {% tag %} ...标签 内容... {% endtag %} )。

for标签

遍历每一个元素:

可以利用 {% for obj in list reversed %} 方向完成循环。

遍历一个字典:

{% for key,val in dic.items %}
  <p>{{ key }}:{{ val }}</p>
{% endfor %}

注:循环序号可以通过 {{ for|loop }} 显示

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 ... empty

for标签带有一个可选的 {% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。

{% for person in person_list %}
  <p>{{ person.name }}</p>

{% empty %}
  <p>sorry,no person here</p>
{% endfor %}

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 %}

with 标签

使用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵”的方法(比如访问数据库)很多次的时候是非常有用的。例如:

{% with total=business.employees.count %}
  {{ total }} employee{{ total|pluralize }}
{% endwith %}

csrf_token 标签

这个标签用于跨站请求伪造保护。

四、自定义标签和过滤器

1、在settings中的INSTALLED_APPS配置当前app,不然Django无法找到自定义的simple_tag。

2、在app中创建templatetags模块(模块名只能是templatetags)。

3、创建任意 .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
 <br>
 @register.simple_tag
 def simple_tag_multi(v1,v2):
   return v1 * v2
 <br>
 @register.simple_tag
 def my_input(id,arg):
   result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
   return mark_safe(result)

4、在使用自定义simple_tag和filter的HTML文件中导入之前创建的my_tags.py。

{% load my_tags %}

5、使用simple_tag和filter(如何调用)

-------------------------------.html
 {% load xxx %}
 # num=12
 {{ num|filter_multi:2 }} #24
 {{ num|filter_multi:"[22,333,4444]" }}
 {% simple_tag_multi 2 5 %} 参数不限,但不能放在if for语句中
 {% simple_tag_multi num 5 %}
注:filter可以用在if等语句后,simpe_tag不可以。
{% if num|filter_multi:30 > 100 %}
  {{ num|filter_multi:30 }}
{% endif %}

五、模板继承(extend)

Django模板引擎中最强大也是最复杂的部分就是模板继承了。模板继承可以让你创建一个基本的“骨架”模板,它包含你站点中的全部元素,并且可以定义能够被子模板覆盖的blocks.

通过从下面这个例子开始,可以容易地理解模板继承:

<!DOCTYPE html>
<html lang="en">
<head>
  <link rel="stylesheet" href="style.css" rel="external nofollow" rel="external nofollow" />
  <title>{% block title %}My amazing site{%/span> endblock %}</title>
</head>

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

  <div id="content">
    {% block content %}{% endblock %}
  </div>
</body>
</html>

假设这个模板叫做 base.html,它定义了一个可以用于两列排版页面的简单HTML骨架。“字模板”的工作是用它们的内容填充的blocks。

在这个例子中,block标签定义了三个可以被子模板内容填充的block。block告诉模板引擎:子模板可能会覆盖掉模板中的这些位置。

子模板可能看起来是这样的:

{% extends "base.html" %}

{% block title %}My amazing blog{% endblock %}

{% block content %}
{% for entry in blog_entries %}
  <h2>{{ entry.title }}</h2>
  <p>{{ entry.body }}</p>
{% endfor %}
{% endblock %}

extends标签是这里的关键。它告诉模板引擎,这个模板“继承”了另一个模板。当模板系统处理这个模板时,首先,它将定位父模板——在此例中,就是 base.html。

那时,模板引擎将注意到 base.html 中的三个block标签,并用子模板中的内容来替换这些block。根据blog_entries的值,输出可能看起来是这样的:

<!DOCTYPE html>
<html lang="en">
<head>
  <link rel="stylesheet" href="style.css" rel="external nofollow" rel="external nofollow" />
  <title>My amazing blog</title>
</head>

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

  <div id="content">
    <h2>Entry one</h2>
    <p>This is my first entry.</p>

    <h2>Entry two</h2>
    <p>This is my second entry.</p>
  </div>
</body>
</html>

请注意,子模版并没有定义 sidebar block,所以系统使用了父模版中的值。父模版的 {% block %} 标签中的内容总是被用作备选内容(fallback)。这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航。

下面是使用继承的一些提示:

  • 如果你在模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况下,模版继承都将无法工作。
  • 在base模版中设置越多的 {% block %} 标签越好。请记住,子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的默认内容,然后,只定义你需要的那一个。多一点钩子总比少一点好。
  • 如果你发现你自己在大量的模版中复制内容,那可能意味着你应该把内容移动到父模版中的一个 {% block %} 中。
  • If you need to get the content of the block from the parent template, the variable will do the trick. This is useful if you want to add to the contents of a parent block instead of completely overriding it. Data inserted using will not be automatically escaped (see the next section), since it was already escaped, if necessary, in the parent template.

为了更好的可读性,你也可以给你的 {% endblock %} 标签一个 名字 。例如:

{% block content %}
...
{% endblock content %}

在大型模板中,这个方法帮你清楚地看到哪一个 {% block %} 标签被关闭了。

不能在一个模版中定义多个相同名字的 block 标签。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • 更换Django默认的模板引擎为jinja2的实现方法

    本机环境 操作系统:fedora24 python版本:3.5 Django版本:1.11.1 jinja2版本:2.9.6 为何要更换 DTL 先来谈谈Django的模板引擎,找了下,并没有一个确定的名字,就简单的叫Django Templates Language(DTL),中文就叫Django模板语言.使用中,大家会发现很多局限性,最明显的就是四则运算.就只能加减,乘除都不支持.另外还有判断相等,不能直接if,要用ifequal.确实不太方便.还有一点,DTL很慢,jinja2宣称比DTL

  • 使用django-suit为django 1.7 admin后台添加模板

    django-grappelli里面使用inline似乎有点儿问题,换一个皮: django-suit是2scoops推荐的第二个admin skin. Supports: Django 1.4-1.7. Python: 2.6-3. 本文的环境是django 1.7.1 django-suit官网 安装指导链接 设置攻略 翻译搬运如下: 安装 复制代码 代码如下: pip install django-suit # settings.py from django.conf.global_set

  • 在Django的模板中使用认证数据的方法

    当前登入的用户以及他(她)的权限可以通过 RequestContext 在模板的context中使用. 注意 从技术上来说,只有当你使用了 RequestContext这些变量才可用. 并且TEMPLATE_CONTEXT_PROCESSORS 设置包含了 "django.core.context_processors.auth" (默认情况就是如此)时,这些变量才能在模板context中使用. TEMPLATE_CONTEXT_PROCESSORS 设置包含了 "djang

  • python Django模板的使用方法(图文)

    模版基本介绍模板是一个文本,用于分离文档的表现形式和内容. 模板定义了占位符以及各种用于规范文档该如何显示的各部分基本逻辑(模板标签). 模板通常用于产生HTML,但是Django的模板也能产生任何基于文本格式的文档.来一个项目说明1.建立MyDjangoSite项目具体不多说,参考前面.2.在MyDjangoSite(包含四个文件的)文件夹目录下新建templates文件夹存放模版.3.在刚建立的模版下建模版文件user_info.html 复制代码 代码如下: <html>    <

  • django使用html模板减少代码代码解析

    看下面两个页面: 一个显示文章列表,一个显示文章详细信息,其中的部分内容相同,有可以重用的部分. 所有就此例可以设置三个html文件:重用部分,目录部分,文章部分. 重用部分: base.html <!DOCTYPE html> <!DOCTYPE html> <html lang="zh-CN"> {% load staticfiles %} <head> <meta charset="utf-8"> &

  • 在Django框架中自定义模板过滤器的方法

    自定义过滤器就是有一个或两个参数的Python函数: (输入)变量的值 参数的值, 可以是默认值或者完全留空 例如,在过滤器 {{ var|foo:"bar" }} 中 ,过滤器 foo 会被传入变量 var 和默认参数 bar. 过滤器函数应该总有返回值. 而且不能触发异常,它们都应该静静地失败. 如果出现错误,应该返回一个原始输入或者空字符串,这会更有意义. 这里是一些定义过滤器的例子: def cut(value, arg): "Removes all values o

  • 使用grappelli为django admin后台添加模板

    grappelli是github上面star最多的django模板系统 http://django-grappelli.readthedocs.org/en/latest/quickstart.html#installation 复制代码 代码如下: pip install django-grappelli settings.py INSTALLED_APPS = (     'grappelli',     'django.contrib.admin', ) 添加url项 复制代码 代码如下:

  • python Django模板的使用方法

    模板是一个文本,用于分离文档的表现形式和内容. 模板定义了占位符以及各种用于规范文档该如何显示的各部分基本逻辑(模板标签). 模板通常用于产生HTML,但是Django的模板也能产生任何基于文本格式的文档. 来一个项目说明 1.建立MyDjangoSite项目具体不多说,参考前面. 2.在MyDjangoSite(包含四个文件的)文件夹目录下新建templates文件夹存放模版. 3.在刚建立的模版下建模版文件user_info.html <html> <meta http-equiv=

  • 浅谈Django自定义模板标签template_tags的用处

    自定义模板标签,过滤器.英文翻译是Customtemplatetagsandfilters.customfilter自定义过滤器今天不在我的记录范围之内,以后用到再看官方文档也不迟. **问题1:**customtemplatetags到底长啥样? customtemplatetags-github Manytemplatetagstakeanumberofarguments–stringsortemplatevariables–andreturnaresultafterdoingsomepro

  • Python的Django框架中模板碎片缓存简介

    你同样可以使用cache标签来缓存模板片段. 在模板的顶端附近加入{% load cache %}以通知模板存取缓存标签. 模板标签{% cache %}在给定的时间内缓存了块的内容. 它至少需要两个参数: 缓存超时时间(以秒计)和指定缓存片段的名称. 示例: {% load cache %} {% cache 500 sidebar %} .. sidebar .. {% endcache %} 有时你可能想缓存基于片段的动态内容的多份拷贝. 比如,你想为上一个例子的每个用户分别缓存侧边栏.

  • python+django加载静态网页模板解析

    接着前面Django入门使用示例 今天我们来看看Django是如何加载静态html的? 我们首先来看一看什么是静态HTML,什么是动态的HTML?二者有什么区别? 静态HTML指的是使用单纯的HTML或者结合CSS制作的包括图片.文字等的只供用户浏览但不包含任何脚本.不含有任何交互功能的网页! 动态的HTML指的是网页不仅提供给用户浏览,网页本身还有交互功能,存在着在脚本如JAVASCRIPT,并利用某种服务器端语言如PHP等实现如用户注册,用户登录,上传文件,下载文件等功能 接下来,了解下加载

  • 编写自定义的Django模板加载器的简单示例

    Djangos 内置的模板加载器(在先前的模板加载内幕章节有叙述)通常会满足你的所有的模板加载需求,但是如果你有特殊的加载需求的话,编写自己的模板加载器也会相当简单. 比如:你可以从数据库中,或者利用Python的绑定直接从Subversion库中,更或者从一个ZIP文档中加载模板. 模板加载器,也就是 TEMPLATE_LOADERS 中的每一项,都要能被下面这个接口调用: load_template_source(template_name, template_dirs=None) 参数 t

随机推荐