Django-jinjia2的赋值
⼀变量
1. 变量的形式是:{{ variable }},当模板引擎碰到变量时,引擎使⽤变量的值替代变量;
2. 使⽤“.”能够访问变量的属性;
3. 当模板引擎碰到“.”的时候,查找顺序是:
a) 字典查找,foo['var'];
b) 属性查找,foo.bar;
c) ⽅法产找,foo.fun();
d) 列表索引查找,foo[bar]
4.如果模板中使⽤的某个变量不存在,那么模板系统将使⽤tting.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对象(w())那么输出将是字符串"Wed 09 Jan 2008"
(b) {{ value | date }},这种形式没有格式化字符串,这时候,格式化字符串会⾃动采⽤DATE_FORMA
T所设置的形式。
意义:将⽇期格式数据按照给定的格式输出
(6)default
使⽤形式:{{ value | default: "nothing" }},例如,如果value是“”,那么输出将是nothing
意义:如果value的意义是Fal,那么输出使⽤缺省值
(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)dictsortreverd
意义:如果value的值是⼀个字典,那么返回值是按照关键字排序的结果的反序
使⽤形式:与上述(8)完全相同。
(10)divisibleby
使⽤形式:{{ value | divisibleby:arg}},如果value是21,arg是3,那么输出将是True
意义:如果value能够被arg整除,那么返回值将是True
(11)escape
使⽤形式:{{ value | escape}}
意义:替换value中的某些字符,以适应HTML格式,包括:
爱情的脚步< is converted to <
> is converted to >
' (single quote) is converted to '
" (double quote) is converted to "
& is converted to &
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 "}}
意义:删除value中的标签。例如,如果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)safeq
与上述safe基本相同,但有⼀点不同的就是:safe是针对字符串,⽽safeq是针对多个字符串组成的quence
(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 ,那么输出将是:
Check out <a href=""></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.内建标签
使⽤形式:
{% autoescape off %}
(内容)
{% endautoescape %}
意义:当某块内容不需要⾃动转义的时候,这样写就可以了。当然如果块内某些地⽅需要转义的话,调⽤filter也可以。
(2)block
酸性溶液
使⽤形式:
{% block %}
(定义块内容)
{% endblock %}
意义:定义⼀个块,该块能够被继承他的⼦孙模板重写
(3)comment
使⽤形式:
{% comment %}
(内容)
{% endcomment %}
意义:模板系统会忽略该标签内部的所有内容。
(4)cycle
使⽤形式:
例如:
<tr class="{% cycle list%}">
...
</tr>
意义:在循环时轮流使⽤给定的字符串列表中的值。
(5)extends
使⽤形式:{% extends "ba.html" %}或者{% extends variable %}变量可以是⼀个字符串,也可以是⼀个模板对象。
意义:表⽰本模板要对指定的⽗模板进⾏扩展。
(6)filter
使⽤形式:
{%filter force_escape|lower%}
(内容)
{%endfilter%}
意义:将filter 标签圈定的内容执⾏过滤器操作。
(7)firstof
使⽤形式:{%firstof var1 var2 var3%}
意义:输出第⼀个值不等于Fal的变量
等价于:
{% if var1 %}
{{ var1 }}
{% el %}
{% if var2 %}
{{ var2 }}
{% el %}
{% if var3 %}
{{ var3 }}
{% endif %}
{% endif %}
{% endif %}
(8)for
使⽤形式:
{% for variable in list/dict %}
(使⽤variable)
{% endfor%}
意义:循环list中的每个值,进⾏相应的输出
注意:(a)也可以反向遍历{% for variable in list/dict reverd %}
(b)也可以{% for x, y in points %} points中的每个元素为 (x,y)
(c)也可以{% for key,value in data.items %} data是⼀个dictionary
for loop中定义的⼀些内建变量
forloop.first 值为True,如果是第⼀次通过迭代器
forloop.last 值为True,如果是最后⼀次通过迭代器
forloop.parentloop 对于嵌套循环,这是当前循环的上⼀层循环
(9)for ... empty
美腿与丑腿使⽤形式如下:
{% for varibale in list %}
(内容1)
{% empty %}
(内容2)
{% endfor %}
意义:当list是空的时候,能够执⾏内容2,其形式等同于,先if判断list是否存在,然后在根据情况做什么操作。
(10)if
使⽤形式如下:
{% if variable %}
(内容1)
{% el %}
(内容2)
{% endif %}
注意:variable中可以使⽤and or 或者not,但是有⼀条必须记住,就是不允许and 和 or⼀起使⽤
(11)ifchanged
(a)如果直接检测循环变量是否变化,那么使⽤: {% ifchanged %} (内容)
{% endifchanged %}
(b)如果检测循环变量的某个dot 变量,例如循环变量是date ,那么检测date.hour ,那么使⽤: {% ifchanged date.hour%} (内容)
{% endifchanged %}
(c)ifchanged 也可以加上⼀个{% el %}语句
意义:检测本次循环的值和上⼀次循环的值⼀样不⼀样,只能⽤在循环⾥⾯。 (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 是格式化字符串
具体的格式化字符串如下所⽰
a
'a.m.' or 'p.m.' (Note that this is slightly different than PHP's output, becau this includes periods
to match Associated Press style.)
'a.m.'A 'AM' or 'PM'.
'AM'b Month, textual, 3 letters, lowerca.'jan'无法不想你
B Not implemented.
d Day of th
e month, 2 digits with leading zeros.'01' to '31'D Day o
f the week, textual, 3 letters.
'Fri'f Time, in 12-hour hours and minutes, with minutes left off if they're zero. Proprietary extension.'1', '1:30'F Month, textual, long.
'January'g Hour, 12-hour format without leading zeros.'1' to '12'G Hour, 24-hour format without leading zeros.'0' to '23'h Hour, 12-hour format.'01' to '12'H Hour, 24-hour format.'00' to '23'i Minutes.
'00' to '59'
I Not implemented.
j Day of the month without leading zeros.'1' to '31'l Day of the week, textual, long.'Friday'L Boolean for whether it's a leap year.True or Fal m Month, 2 digits with leading zeros.'01' to '12'M Month, textual, 3 letters.'Jan'n Month without leading zeros.
'1' to '12'
N Month abbreviation in Associated Press style. Proprietary extension.'Jan.', 'Feb.', 'March', 'May'O Difference to Greenwich time in hours.'+0200'
P
Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off if they're zero and the special-ca strings 'midnight' and 'noon' if appropriate. Proprietary extension.
'', '1:', 'midnight','noon', '12:'r RFC 2822 formatted date.
'Thu, 21 Dec 2000 16:01:07+0200's Seconds, 2 digits with leading zeros.
'00' to '59'S English ordinal suffix for day of the month, 2 characters.'st', 'nd', 'rd' or 'th't Number of days in the given month.28 to 31T Time zone of this machine.'EST', 'MDT'
U Not implemented.
w Day of the week, digits without leading zeros.
'0' (Sunday) to '6' (Saturday)W ISO-8601 week number of year, with weeks starting on Monday.1, 53y Year, 2 digits.'99'Y Year, 4 digits.'1999'z Day of the year.0 to 365
Z
Time zone offt in conds. The offt for timezones west of UTC is always negative, and for tho east of UTC is always positive.