Django笔记教程:二、模版

原创 2015年11月21日 01:22:49

Django笔记教程:2、模版

一、变量

1.变量的形式是:{{variable}}, 当模板引擎碰到变量的时候,引擎使用变量的值代替变量。
2.使用dot(.)能够访问变量的属性
3.当模板引擎碰到dot的时候,查找的顺序是什么样子呢?
    a.字典查找,例如:foo["var1"]
    b.属性查找,例如:foo.bar
    c.方法查找,例如:foo.bar()
    d.list-index查找,例如foo[bar]
    注意:方法查找比一般的查找要复杂一些
    (1)如果调用方法期间,方法抛出一个异常,那么异常将会产生,除非异常对象带有一个属性silent_variable_failure,
    如果这个值是True,那么将会返回一个空字串。
    (2)方法调用仅仅对那些没有参数的方法才会生效
    (3)一些方法会产生副作用,所以系统允许方法设置一个属性alters_data,如果值为True,那么将不能够调用
4.如果模板中使用的某个变量不存在,那么模板系统将使用setting.py中 变量TEMPLATE_STRING_IF_INVALID的值进行替代,在默认情况下,该变量的值是''。

二、过滤器

1.可以通过过滤器来修改变量的显示,过滤器的形式是:{{ variable | filter }},管道符号'|'代表使用过滤器
2.过滤器能够采用链式的方式使用,例如:{{ text | escape | linebreaks }}
3.过滤器还可以带参数,例如: {{ bio|truncatewords:30 }}
4.过滤器的参数中如果带有空格,那么需要用引号引起来,例如:{{ list | join : ", "}}
5.django中30个内建的过滤器
    (1)add  
        使用形式为:{{ value | add: "2"}}
        意义:将value的值增加2
    (2)addslashes
        使用形式为:{{ value | addslashes }}
        意义:在value中的引号前增加反斜线
    (3)capfirst
        使用形式为:{{ value | capfirst }}
        意义:value的第一个字符转化成大写形式
    (4)cut
         使用形式为:{{ value | cut:arg}}, 例如,如果value是“String with spaces” arg是" "那么输出是"Stringwithspaces"
         意义:从给定value中删除所有arg的值
    (5)date
         使用形式为::
             (a) {{ value | date:"D d M Y" }},例如,如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串"Wed 09 Jan 2008"
             (b) {{ value | date }},这种形式没有格式化字符串,这时候,格式化字符串会自动采用DATE_FORMAT所设置的形式。
         意义:将日期格式数据按照给定的格式输出
    (6)default
         使用形式:{{ value | default: "nothing" }},例如,如果value是“”,那么输出将是nothing
         意义:如果value的意义是False,那么输出使用缺省值
    (7)default_if_none
         使用形式:{{ value | default_if_none:"nothing" }},例如,如果value是None,那么输出将是nothing
         意义:如果value是None,那么输出将使用缺省值
    (8)dictsort
         意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果
         使用形式:{{ value | dictsort:"name"}},例如,
         如果value是:
            [
            {'name': 'zed', 'age': 19},
            {'name': 'amy', 'age': 22},
            {'name': 'joe', 'age': 31},
            ]
            那么,输出是:
            [
            {'name': 'amy', 'age': 22},
            {'name': 'joe', 'age': 31},
            {'name': 'zed', 'age': 19},
            ]

(9)dictsortreversed
意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果的反序
使用形式:与上述(8)完全相同。
(10)divisibleby
使用形式:{{ value | divisibleby:arg}},如果value是21,arg是3,那么输出将是True
意义:如果value能够被arg整除,那么返回值将是True
(11)escape
使用形式:{{ value | escape}}
意义:替换value中的某些字符,以适应HTML格式,包括:
'''< is converted to &lt;
> is converted to &gt;
' (single quote) is converted to &#39;
" (double quote) is converted to &quot;
& is converted to &amp;'''

escape仅仅在输出的时候才起作用,所以escape不能够用在链式过滤器的中间,
他应该总是最后一个过滤器,如果想在链式过滤器的中间使用,那么可以使用force_escape

(12)escapejs
使用形式:{{ value | escapejs }}
意义:替换value中的某些字符,以适应JAVASCRIPT和JSON格式。
(13)filesizeformat
使用形式:{{ value | filesizeformat }}
意义:格式化value,使其成为易读的文件大小,例如:13KB,4.1MB等。
(14)first
使用形式:{{ value | first }}
意义:返回列表中的第一个Item,例如,如果value是列表['a','b','c'],那么输出将是'a'。
(15)floatformat
使用形式:{{ value | floatformat}}或者{{value|floatformat:arg}},
arg可以是正数也可以是负数。没有参数的floatformat相当于floatformat:-1
(1)如果不带arg,那么引擎会四舍五入,同时最多只保留一位小数。
34.23234    {{ value|floatformat }} 34.2
34.00000    {{ value|floatformat }} 34
34.26000    {{ value|floatformat }} 34.3
(2)如果arg是正数,那么引擎会四舍五入,同时保留arg位的小数。
34.23234    {{ value|floatformat:3 }}   34.232
34.00000    {{ value|floatformat:3 }}   34.000
34.26000    {{ value|floatformat:3 }}   34.260
(3)如果arg是负数,那么引擎会四舍五入,如果有小数部分,那么保留arg位小数;否则,则没有任何小数部分。
34.23234    {{ value|floatformat:"-3" }}    34.232
34.00000    {{ value|floatformat:"-3" }}    34
34.26000    {{ value|floatformat:"-3" }}    34.26
(16)get_digit
使用形式:{{ value | get_digit:"arg"}},例如,如果value是123456789,arg是2,那么输出是8
意义:给定一个数字,返回,请求的数字,记住:1代表最右边的数字,如果value不是合法输入,
那么会返回所有原有值。
(17)iriencode
使用形式:{{value | iriencode}}
意义:如果value中有非ASCII字符,那么将其进行抓化成URL中适合的编码,如果value已经进行过URLENCODE,
改操作就不会再起作用。
(18)join
使用形式:{{ value | join:"arg"}},如果value是['a','b','c'],arg是'//'那么输出是a//b//c
意义:使用指定的字符串连接一个list,作用如同python的str.join(list)
(19)last
使用形式:{{ value | last }}
意义:返回列表中的最后一个Item
(20)length
使用形式:{{ value | length }}
意义:返回value的长度。
(21)length_is
使用形式:{{ value | length_is:"arg"}}
意义:返回True,如果value的长度等于arg的时候,例如:如果value是['a','b','c'],arg是3,那么返回True
(22)linebreaks
使用形式:{{value|linebreaks}}
意义:value中的"\n"将被<br/>替代,并且整个value使用</p>包围起来,从而适和HTML的格式
(23)linebreaksbr
使用形式:{{value |linebreaksbr}}
意义:value中的"\n"将被<br/>替代
(24)linenumbers
使用形式:{{value | linenumbers}}
意义:显示的文本,带有行数。
(25)ljust
使用形式:{{value | ljust}}
意义:在一个给定宽度的字段中,左对齐显示value
(25)center
使用形式:{{value | center}}
意义:在一个给定宽度的字段中,中心对齐显示value 
(25)rjust
使用形式:{{value | rjust}}
意义:在一个给定宽度的字段中,右对齐显示value
(26)lower
使用形式:{{value | lower}}
意义:将一个字符串转换成小写形式
(27)make_list
使用形式:{{value | make_list}}
意义:将value转换成一个list,对于字符串,转换成字符list;对于整数,转换成整数list
例如value是Joel,那么输出将是[u'J',u'o',u'e',u'l'];value是123,那么输出将是[1,2,3]
(28)pluralize
使用形式:{{value | pluralize}},或者{{value | pluralize:"es"}},或者{{value | pluralize:"y,ies"}}
意义:如果value不是1,则返回一个复数后缀,缺省的后缀是's'
(29)random
使用形式:{{value | random}}
意义:从给定的list中返回一个任意的Item
(30)removetags
使用形式:{{value | removetags:"tag1 tag2 tag3..."}}
意义:删除value中tag1,tag2....的标签。例如,如果value是<b>Joel</b> <button>is</button> a <span>slug</span>
tags是"b span",那么输出将是:Joel <button>is</button> a slug
(31)safe
使用形式:{{value | safe}}
意义:当系统设置autoescaping打开的时候,该过滤器使得输出不进行escape转换
(32)safeseq
与上述safe基本相同,但有一点不同的就是:safe是针对字符串,而safeseq是针对多个字符串组成的sequence
(33)slice
使用形式:'''{{some_list | slice:":2"}}'''
意义:与python语法中的slice相同,:2表示第一的第二个元素
(34)slugify
使用形式:'''{{value | slugify}}'''
意义:将value转换成小写形式,同事删除所有分单词字符,并将空格变成横线
例如:如果value是Joel is a slug,那么输出将是joel-is-a-slug
(35)stringformat
这个不经常用,先不说
(36)striptags
使用形式:{{value | striptags}}
意义:删除value中的所有HTML标签
(37)time
使用形式:{{value | time:"H:i"}}或者{{value | time}}
意义:格式化时间输出,如果time后面没有格式化参数,那么输出按照TIME_FORMAT中设置的进行。
(38)title
转换一个字符串成为title格式。
(39)truncatewords
使用形式:{{value | truncatewords:2}}
意义:将value切成truncatewords指定的单词数目
例如,如果value是Joel is a slug 那么输出将是:Joel is ...
(40)truncatewords_html
使用形式同(39)
意义:truncation点之前如果某个标签打开了,但是没有关闭,那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低,所有只有在value是html格式时,才考虑使用。
(41)upper
转换一个字符串为大写形式
(42)urlencode
将一个字符串进行URLEncode
(43)urlize
意义:将一个字符串中的URL转化成可点击的形式。
使用形式:{{ value | urlize }}
例如,如果value是Check out www.djangoproject.com,那么输出将是:
Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a>
(44)urlizetrunc
使用形式:{{ value | urlizetrunc:15}}
意义:与(43)相同,但是有一点不同就是现实的链接字符会被truncate成特定的长度,后面以...现实。
(45)wordcount
返回字符串中单词的数目
(46)wordwrap
使用形式:{{value | wordwrap:5}}
意义:按照指定的长度包装字符串
例如,如果value是Joel is a slug,那么输出将会是:
Joel
is a
slug
(47)timesince
使用形式:{{value | timesince:arg}}
意义:返回参数arg到value的天数和小时数
例如,如果 blog_date 是一个日期实例表示 2006-06-01 午夜, 而 comment_date 是一个日期实例表示 2006-06-01 早上8点,
那么 {{ comment_date|timesince:blog_date }} 将返回 "8 hours".
(48)timeuntil
使用形式:{{value | timeuntil}}
意义:与(47)基本相同,一个不同点就是,返回的是value距离当前日期的天数和小时数。

三、语法控制流

1.标签的形式是:{% tag %},标签要比变量复杂
2.标签的作用
(1)在输出时创建一些文本
(2)通过执行循环和一些逻辑来实现控制流
(3)装载一些外部信息进入模板
3.内建标签
(1)autoescape
使用形式:
{% autoescape off %}
(内容)
{% endautoescape %}
意义:当某块内容不需要自动转义的时候,这样写就可以了。当然如果块内某些地方需要转义的话,调用filter也可以。
(2)block
使用形式:
{% block %}
(定义块内容)
{% endblock %}
意义:定义一个块,该块能够被继承他的子孙模板重写
(3)comment
使用形式:
{% comment %}
(内容)
{% endcomment %}
意义:模板系统会忽略该标签内部的所有内容。
(4)cycle
使用形式:
例如:
<tr class="{% cycle list%}">
...
</tr>
意义:在循环时轮流使用给定的字符串列表中的值。

(5)extends
使用形式:{% extends "base.html" %}或者{% extends variable %}变量可以是一个字符串,也可以是一个模板对象。
意义:表示本模板要对指定的父模板进行扩展。
(6)filter
使用形式:
{%filter force_escape|lower%}
(内容)
{%endfilter%}
意义:将filter 标签圈定的内容执行过滤器操作。
(7)firstof
使用形式:{%firstof var1 var2 var3%}
意义:输出第一个值不等于False的变量
等价于: 
{% if var1 %}
{{ var1 }}
{% else %}
{% if var2 %}
{{ var2 }}
{% else %}
{% if var3 %}
{{ var3 }}
{% endif %}
{% endif %}
{% endif %}
(8)for
使用形式:
{% for variable in list/dict %}
(使用variable)
{% endfor%}
意义:循环list中的每个值,进行相应的输出
注意:
(a)也可以反向遍历{% for variable in list/dict reversed %}
(b)也可以{% for x, y in points %} points中的每个元素为 (x,y)
(c)也可以{% for key,value in data.items %} data是一个dictionary 
for loop中定义的一些内建变量
    forloop.counter 当前的迭代器数目(从1开始)
    forloop.counter0 当前的迭代器数目(从0开始)
    forloop.revcounter 当前的反向迭代器数目(从1开始)
    forloop.revcounter0 当前的反向迭代器数目(从0开始)
    forloop.first 值为True,如果是第一次通过迭代器
    forloop.last 值为True,如果是最后一次通过迭代器
    forloop.parentloop 对于嵌套循环,这是当前循环的上一层循环

django forloop如下:

在每个{% for %}循环里有一个称为forloop 的模板变量。这个变量有一些提示循环进度信息的属性。

forloop.counter 总是一个表示当前循环的执行次数的整数计数器。 这个计数器是从1开始的,所以在第一次循环时 forloop.counter 将会被设置为1。
{% for item in todo_list %}

{{ forloop.counter }}: {{ item }}


{% endfor %}
forloop.counter0 类似于 forloop.counter ,但是它是从0计数的。 第一次执行循环时这个变量会被设置为0。
forloop.revcounter 是表示循环中剩余项的整型变量。 在循环初次执行时 forloop.revcounter 将被设置为序列中项的总数。 最后一次循环执行中,这个变量将被置1。
forloop.revcounter0 类似于 forloop.revcounter ,但它以0做为结束索引。在第一次执行循环时,该变量会被置为序列的项的个数减1。
forloop.first 是一个布尔值,如果该迭代是第一次执行,那么它被置为““ 在下面的情形中这个变量是很有用的:
System Message: WARNING/2 (, line 1071); backlink
Inline literal start-string without end-string.
{% for object in objects %}
{% if forloop.first %}
  • {% else %}
  • {% endif %}
    {{ object }}
  • {% endfor %}
    forloop.last 是一个布尔值;在最后一次执行循环时被置为True。 一个常见的用法是在一系列的链接之间放置管道符(|)
    {% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}
    上面的模板可能会产生如下的结果:
    Link1 | Link2 | Link3 | Link4
    另一个常见的用途是为列表的每个单词的加上逗号。
    Favorite places:
    {% for p in places %}{{ p }}{% if not forloop.last %}, {% endif %}{% endfor %}
    forloop.parentloop 是一个指向当前循环的上一级循环的 forloop 对象的引用(在嵌套循环的情况下)。 例子在此:
    {% for country in countries %}

    {% for city in country.city_list %}





    {% endfor %}
    Country #{{ forloop.parentloop.counter }} City #{{ forloop.counter }} {{ city }}

    {% endfor %}
    forloop 变量仅仅能够在循环中使用。 在模板解析器碰到{% endfor %}标签后,forloop就不可访问了。

    Context和forloop变量
    在一个 {% for %} 块中,已存在的变量会被移除,以避免 forloop 变量被覆盖。 Django会把这个变量移动到 forloop.parentloop 中。通常我们不用担心这个问题,但是一旦我们在模板中定义了 forloop 这个变量(当然我们反对这样做),在 {% for %} 块中它会在 forloop.parentloop 被重新命名。
    (9)for … empty
    使用形式如下:
    {% for varibale in list %}
    (内容1)
    {% empty %}
    (内容2)
    {% endfor %}
    意义:当list是空的时候,能够执行内容2,其形式等同于,先if判断list是否存在,然后在根据情况做什么操作。
    (10)if
    使用形式如下 :
    {% if variable %}
    (内容1)
    {% else %}
    (内容2)
    {% endif %}
    注意:variable中可以使用and or 或者not,但是有一条必须记住,就是不允许and 和 or一起使用
    (11)ifchanged
    使用形式:
    (a)如果直接检测循环变量是否变化,那么使用:
    {% ifchanged %}
    (内容)
    {% endifchanged %}
    (b)如果检测循环变量的某个dot变量,例如循环变量是date,那么检测date.hour,那么使用:
    {% ifchanged date.hour%}
    (内容)
    {% endifchanged %}
    (c)ifchanged也可以加上一个{% else %}语句
    意义:检测本次循环的值和上一次循环的值一样不一样,只能用在循环里面。
    (12)ifequal
    使用形式:
    {% ifequal variable1 variable2 %}

    {% endifequal %}
    意义:判断两个变量是否相等。
    (13)ifnotequal
    使用与(12)相同
    (14)include
    使用形式:{% include “foo/bar.html” %}或者{% include template_name %}
    意义:将另外一个模板文件中的内容添加到该文件中。注意区别extend是继承。
    (15)now
    使用形式:{% now “jS F Y H:i “%},注意存在需要转义的情况例如{% now “jS o\f F” %},因为f是格式化字符串.
    (16)spaceless
    使用形式:{% spaceless %}
    (内容)
    {% endspaceless %}
    意义:删除包围内容中的所有tab或者回车字符。
    (17)template
    使用形式:{% templatetag %}
    意义:模板系统本身没有转义的概念,因此如果要输出一个像“{%”这样的东东,就需要采用这种方式,否则就会语法错误
    其参数有:
    openblock {%
    closeblock %}
    openvariable {{
    closevariable }}
    openbrace {
    closebrace }
    opencomment {#
    closecomment #}

    (18)with
    使用形式:
    {% with "expensive var1" as var2 %}
    {% endwith %}
    意义:当一个变量的访问消耗很大的模板解析时,可以用另外一个变量替换它,这种替换只有在with内部有效。
    (19)url
    使用形式:{% url path.to.some_view arg1,arg2 %}
    意义:给定某个module中函数的名字,给定参数,那么模板引擎给你一个URL,从而避免硬编码URL到代码中
    
    注意:前提是URLconf中存在相应的映射,如果URLconf中没有该映射,那么会抛出异常,
    这是可以选择使用
    {% url path.to.view arg1 ,arg2 as the url %}
    <a href="{{ the_url }}">Link to optional stuff</a>
    其实这相当于
    {% url path.to.view as the_url %}
    {% if the_url %}
    <a href="{{ the_url }}">Link to optional stuff</a>
    {% endif %}
    
    版权声明:本文为博主原创文章,未经博主允许不得转载。

    Django实战:构建一个blog

    一,创建项目django-admin.py startproject mysite如下图所示: 运行该命令后,就会在当前目录下创建一个目录mysite二,测试开发服务器 进入到mysite目录...
    • u011943221
    • u011943221
    • 2015年07月24日 11:12
    • 1162

    django 模版语言

    一、django模板的组织形式 首先看下面例子: 标题 Dear {{ person_name }}, Thanks for...
    • Inuyasha1121
    • Inuyasha1121
    • 2015年02月26日 13:01
    • 920

    django创建自定义模板处理器

    django创建自定义模板处理器:一、需求来源:在django开发中,页面是通过template(模板)进行渲染的,对于一些数据,可以通过{{ 变量 }}的方式进行传递。但是,如果整个网站中,或者整个...
    • huangyong1314
    • huangyong1314
    • 2016年07月25日 23:58
    • 1030

    django 模板语法

    显示的数据必须是后端view.py传输的数据 名字 1.普通输出     {{ i }} 2.for 循环     {% for i in TutorialList %} ...
    • lyj1101066558
    • lyj1101066558
    • 2016年06月28日 10:12
    • 503

    Django模板中常用过滤器(filter)

    在使用模板中的过滤器和标签的时候,不熟悉官方文档的话。空格一定不要乱加,以官方文档为主,有时候乱加空格可能会报错。 所有内容在官方文档(打开链接)中,下面是常用的几个 1.add 给变量加上相应...
    • You_are_my_dream
    • You_are_my_dream
    • 2016年11月07日 15:26
    • 1832

    Django下静态模板的继承

    Django下静态模板的继承前言:第一篇博客,毕业校招在即,抽空把做过的项目都整理一下。 开发环境:python3.4,django1.8 初入python和django做项目,遇...
    • qq_34787226
    • qq_34787226
    • 2016年09月12日 22:00
    • 680

    Django 模板中变量、过滤器、标签的使用方法

    一 变量 1. 变量的形式
    • qiaojun_peng
    • qiaojun_peng
    • 2014年05月15日 14:19
    • 1472

    DJANGO 1.8模版配置

    在使用django1.8的时候,配置模版遇到了个不小的问题,按照默认设置配置模版和views后一直报错,找不到模版,搜索了很多相关信息后终于找到了解决方案。去掉settings.py中的TEMPLAT...
    • frone
    • frone
    • 2015年05月20日 18:13
    • 861

    Django模板渲染

    模板渲染 一旦你创建一个 Template 对象,你可以用 context 来传递数据给它。 一个 context 是一 系列变量和它们值的集合。模板使用它来赋值模板变量标签和 执行块标签。 c...
    • Mr_JJ_Lian
    • Mr_JJ_Lian
    • 2011年09月17日 21:53
    • 3620

    Python3之Django Web框架模板篇(templates)与自定义filter与tag

    什么是模板: html加模板语法 模板语法变量: 形式:{{variable}} 深度查询:使用句点符号“.” 过滤器:{{variable|filter_name}} 标签 ...
    • qq_33733970
    • qq_33733970
    • 2017年10月24日 15:11
    • 158
    内容举报
    返回顶部
    收藏助手
    不良信息举报
    您举报文章:Django笔记教程:二、模版
    举报原因:
    原因补充:

    (最多只允许输入30个字)