Django的模板系统

Posted

tags:

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

模板系统介绍

模板系统的组成:html代码和逻辑控制代码

逻辑控制代码可以理解是django模板语言

django的模板语言组成

  1. 变量(使用双大括号来引用变量):

  2. 标签(tag)的使用(使用大括号和百分比的组合来表示使用tag)
  3. 模板继承

模板语言之变量

语法:

{{var_name}}   var_name 指变量名

  

使用模板语言之前:

先介绍template对象和Context对象

进入django的项目的交互环境

python manange.py shell

>>> from django.template import Context, Template
>>> t = Template(\'My name is {{ name }}.\')   #模板对象
>>> c = Context({\'name\': \'xixi\'})       #上下文对象
>>> t.render(c)
\'My name is xixi.\'

  

同一模板,多个上下文,一旦有了模板对象,你就可以通过它渲染多个context,无论何时我们都可以像这样使用同一模板源渲染多个context,只进行 一次模板创建然后多次调用render()方法渲染会更为高效:

模板对象:可以理解文HTML文件,只不过包含了Django的模板语法

context对象:大多数的情况下,我们会将字典传给Context(),一旦初始化后,就可以使用标准的Python字典语法操作Context对象:

 

上下文对象如果是不合法的变量,模板系统会把他当做空字符串显示

>>> t = Template(\'Your name is {{  name }}\')   变量名是name
>>> t.render(Context({\'var\':\'hello\'}))  #没有var这个变量名字
\'Your name is \'

  

变量之深度查询(英文句点符.)

上面只是通过 context 传递的简单参数值主要是字符串,然而,模板系统能够非常简洁地处理更加复杂的数据结构,例如list、dictionary和自定义的对象。

 

list索引

>>> from django.template import Context, Template
>>> names = ["xixi","abc","123","hehe"]
>>> t = Template("this is {{ name.0}}")
>>> c = Context({"name":names})
>>> t.render(c)
\'this is xixi\'

  

如果不写 {{ name.0}}  后面的(.索引) 表示整个列表

字典

>>> from  django.template  import  Template, Context
>>> person = {\'name\':"xixi", "age": 21}
>>> t = Template("{{ person.name }} is {{ person.age }} years old.")
>>> c = Context({ "person": person })
>>> t.render(c)
\'xixi is 25 years old.\'

  

自定义对象

>>> from   django.template  import  Template, Context
>>> import  datetime
>>> d = datetime.date(1996, 12,12 )
>>> d.year
1996
>>> d.month
12
>>> d.day
12
>>> t = Template(\'The month is {{ date.month }} and year is {{ date.year }}\')
>>> c = Context({\'date\': d})
>>> t.render(c)
\'The month is 12 and year is 1996\'

  

访问对象方法

>>> t = Template(\'{{ var }} -- {{ var.upper }} -- {{  var.isdigit }}\')
>>> t.render(Context({\'var\': \'hello\'}))
\'hello -- HELLO -- False\'
>>> t.render(Context({\'var\': \'123\'}))
\'123 -- 123 -- True\'

  

跟python操作差不多

 

变量过滤器(filter)的使用

语法格式

{{var|filter:param}}

  

管道符号后面的功能,比如{{ var|length }},求变量长度的 length 就是一个过滤器。

常用的过滤器

 

 1.add          :   给变量加上相应的值
  
2 addslashes   :    给变量中的引号前加上斜线
 
3  capfirst     :    首字母大写
 
4  cut          :   从字符串中移除指定的字符
 
5  date         :   格式化日期字符串

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

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

  

标签(tag)的使用

语法格式

{% tags %}

  

{% if %} 的使用

 

{% if %} 和 {% endif %}要成对

{% 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 %} 和 {% endfor %}要成对

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

  

{% for %}不支持中断循环,也不支持continue语句

{% for %}关于循环其他用法

forloop.counter表示循环的次数,它从1开始计数,第一次循环设为1:
forloop.counter0	索引从 0 开始算
forloop.revcounter表示循环中剩下的items数量,第一次循环时设为items总数,最后一次设为1
forloop.revcounter0表示`items总数少一个,最后一次循环设置为0
forloop.first表示当第一次循环时值为True,在特别情况下很有用:
forloop.last表示当最后一次循环时值为True
forloop。parentioop表示在嵌套循环中表示父级循环的forloop

  

 

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

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

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

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

 

{% for item in todo_list %}
        <p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}
表示循环的次数,它从1开始计数,第一次循环设为1:

  

{%csrf_token%}:csrf_token标签

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

 

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

<form action="{% url "路由别名"%}" >
          <input type="text">
          <input type="submit"value="提交">
          {%csrf_token%}
</form>

  

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

{% with total=fhjsaldfhjsdfhlasdfhljsdal %} {{ total }} {% endwith %}
基本很少起复杂变量名,一般起变量名都要特变形象

  

{% verbatim %}: 禁止render渲染

{% verbatim %}
         {{ hello }}
{% endverbatim %


如果想要{{hello}}在网页正常显示出来,则用这个

  

{% load %}: 加载标签库 


静态文件的引入方式用过

{% load  staticfiles %}

后面引入其他的标签库在一一列出

 

 

自定义filter和simple_tag

我们自定义过滤器和简单的标签我们需要

  1. 在app中创建templatetags文件夹(文件夹名字必须的是这个)
  2. 创建任意 .py 文件,如:my_tags.py

 

#!/usr/bin/env python
#-*- coding:utf-8 -*-
from django import template
from django.utils.safestring import mark_safe
register = template.Library()  #register的名字是固定的,不可改变

@register.filter
def filter_multi(x,y):
    return x*y

@register.simple_tag
def simple_tag_multi(x,y):
    return x*y

@register.simple_tag
def my_input(id,arg):
    result = "<input type=\'text\' id=\'%s\' class=\'%s\' />" %(id,arg)
    return mark_safe(result)

  

如何调用自定义filter和simple_tag

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

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

{% load my_tags %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
{{ num|filter_multi:2 }} #24 <br>

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


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

</body>
</html>

  

视图和路由的配置文件

#路由
from django.conf.urls import url
from django.contrib import admin
from app01 import views

urlpatterns = [
    url(r\'^admin/\', admin.site.urls),
    url(r\'^index/\',views.index),
]


#视图

from django.shortcuts import render,HttpResponse

# Create your views here.
def index(request):

    num=12
    return  render(request,"index.html",locals())

  

注:filter可以用在if等语句后,simple_tag不可以

 

模板引入和继承

模板引入

 {% include %}该标签允许在(模板中)包含其它的模板的内容。 标签的参数是所要包含的模板名称,可以是一个变量,也可以是用单/双引号硬编码的字符串。 每当在多个模板中出现相同的代码时,就应该考虑是否要使用 {% include %} 来减少重复。

引入方法

{% load staticfiles %}

HTML相关内容


{% include \'要引入的html文件名\' %}

  

模板继承

常见的 Web 开发问题: 在整个网站中,如何减少共用页面区域(比如站点导航)所引起的重复和冗余代码?

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

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

 

如果子板不自定义块,默认会继承母板的所有内容(包括模板的css,js),如果子板要修改css或js文件,在相应地方加块,就可以了

 

例如:

简单写一个子板继承母板

定义母板文件base.html,定义子板要自定义的块

  

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<H1> HAHA </H1>

{% block  content %}
    <h2>子板自定义修改的内容</h2>

{% endblock %}
</body>
</html>

  

定义子板文件child.html

{% extends "base.html" %}

  

子板如果就这么一行代码,就会继承母板的所有内容,这{% extends "母板文件" %}必须写在最首行

 

如果要自定义修改块

{% extends "base.html" %}
{% block content %}
    <h2 style="color: red">我是子板,修改了母板自定义块的内容</h2>
{% endblock %}

  

注:

母板

{% block 自定义块名%}   

 

子板的块

{% block 母板中相应设置的块名 }

 

{% block %}  内容 {% endblock %}的标签也是成对出现

 

使用继承的注意事项:

  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 %} 标签,父模板将无从得知要使用哪个块的内容。

 

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

JavaScript 片段在 Django 模板中不起作用

如何在扩展另一个文件的 django 模板中使用带有动态内容的 html 块片段?

Django模板过滤器 - 一行

Django的模板系统

Django的模板系统

如何在Django视图中使用for循环返回每次迭代[关闭]