Djagno入门：template之标签

【转载】

三、标签

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 对于嵌套循环，这是当前循环的上一层循环

(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是格式化字符串

具体的格式化字符串如下所示

a ‘a.m.’ or ‘p.m.’ (Note that this is slightly different than PHP’s output, because this includes periods to match Associated Press style.) ‘a.m.’

A ‘AM’ or ‘PM’. ‘AM’

b Month, textual, 3 letters, lowercase. ‘jan’

B Not implemented.

d Day of the month, 2 digits with leading zeros. ‘01’ to ‘31’

D Day of 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 False

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-case strings ‘midnight’ and ‘noon’ if appropriate. Proprietary extension. ‘1 a.m.’, ‘1:30 p.m.’, ‘midnight’, ‘noon’, ‘12:30 p.m.’

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 31

T 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, 53

y Year, 2 digits. ‘99’

Y Year, 4 digits. ‘1999’

z Day of the year. 0 to 365

Z Time zone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive.

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