附录 F:内建的模板标签和过滤器

1.内建标签参考

block

定义一个能被子模板覆盖的区块。参见第四章“模板继承”一节查看更多信息。

comment

模板引擎会忽略掉 {% comment %} 和 {% endcomment %} 之间的所有内容。

cycle

轮流使用标签给出的字符串列表中的值。

在一个循环内，轮流使用给定的字符串列表元素：

{% for o in some_list %}
    
        ...
    
{% endfor %}

在循环外，在你第一次调用时，给这些字符串值定义一个不重复的名字，以后每次只需使用这个名字就行了：

...
...
...

你可以使用任意数量的用逗号分隔的值。注意不要在值与值之间有空格，只是一个逗号。

debug

输出完整的调试信息，包括当前的上下文及导入的模块信息。

extends

标记当前模板扩展一个父模板。

这个标签有两种用法：

• {% extends "base.html" %} （带引号） 直接使用要扩展的父模板的名字 "base.html" 。

• {% extends variable %} 用变量 variable 的值来指定父模板。如果变量是一个字符串，Django会把字符串的值当作父模板的文件名。如果变量是一个 Template 对象，Django会把这个对象当作父模板。

参看第四章更多应用实例。

filter

通过可变过滤器过滤变量的内容。

过滤器也可以相互传输，它们也可以有参数，就像变量的语法一样。

看这个用法实例：

{% filter escape|lower %}
    This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}

firstof

输出传入的第一个不是 False 的变量，如果被传递变量都为 False ，则什么也不输出。

看这个用法实例：

{% firstof var1 var2 var3 %}

这等同于如下内容：

{% if var1 %}
    {{ var1 }}
{% else %}{% if var2 %}
    {{ var2 }}
{% else %}{% if var3 %}
    {{ var3 }}
{% endif %}{% endif %}{% endif %}

for

轮询数组中的每一元素。例如显示一个指定的运动员的序列 athlete_list ：

{% for athlete in athlete_list %}
    
{{ athlete.name }}

{% endfor %}

你也可以逆向遍历一个列表 {% for obj in list reversed %} 。

for 循环设置了许多循环中可用的变量（见表F-1）。

表F-1. {% for %}循环中的可用变量

变量名	描述
forloop.counter	当前循环次数（索引最小为1）。
forloop.counter0	当前循环次数 (索引最小为0)。
forloop.revcounter	剩余循环次数 (索引最小为1)。
forloop.revcounter0	剩余循环次数 (索引最小为0)。
forloop.first	第一次循环时为 True 。
forloop.last	最后一次循环时为 True 。
forloop.parentloop	用于嵌套循环，表示当前循环外层的循环。

8.if

{% if %} 标签测试一个变量，若变量为真（即其存在、非空，且不是一个为假的布尔值），区块中的内容就会被输出：

{% if athlete_list %}
    Number of athletes: {{ athlete_list|length }}
{% else %}
    No athletes.
{% endif %}

若 athlete_list 非空，变量 {{ athlete_list|length }} 就会显示运动员的数量。

正如你所见， if 标签有可选的 {% else %} 从句，若条件不成立则显示该从句。

if 语句可使用 and 、 or 和 not 来测试变量或者对给定的变量取反：

ifchanged

检查循环中一个值从最近一次重复其是否改变。

ifchanged 语句块用于循环中，其作用有两个：

它会把要渲染的内容与前一次作比较，发生变化时才显示它。例如，下面要显示一个日期列表，只有月份改变时才会显示它：

Archive for {{ year }}


{% for date in days %}
    {% ifchanged %}
{{ date|date:"F" }}
{% endifchanged %}
    {{ date|date:"j" }}
{% endfor %}

ifequal

如果两个参数相等，就输出该区块的内容。

ifnotequal

和 ifequal 类似，不过它是用来测试两个参数是 不 相等的。

include

加载一个模板，并用当前上下文对它进行渲染，这是在一个模板中包含其他模板的一种方法。

模板名可以是一个变量或者是一个硬编码（引号引起来的）的字符串，引号可以是单引号或者双引号。

这个例子包含了 "foo/bar.html" 模板的内容：

{% include "foo/bar.html" %}

load

读入一个自定义的模板库。（自定义标签加载进来）

spaceless

去除HTML标签之间的空白符号，包括制表符和换行符。

内建过滤器

Built-in Filter Reference

add

例如：

{{ value|add:"5" }}       表示这个值加5

Adds the argument to the value.

addslashes

例如：

{{ string|addslashes }}

Adds backslashes before single and double quotes. This is useful for passing strings to JavaScript, for example.

capfirst

例如：

{{ string|capfirst }}

将字符串的首字母大写

center

例如：

cut

例如：

{{ string|cut:"spam" }}

Removes all values of the argument from the given string.

date

Example:

{{ value|date:"F j, Y" }}

Formats a date according to the given format (same as the now tag).

dictsort

例如：

{{ list|dictsort:"foo" }}

divisibleby  （判断能否整除）

Example:

{% if value|divisibleby:"2" %}
    Even!
{% else %}
    Odd!
{% else %}

Returns True if the value is divisible by the argument.

escape

Example:

{{ string|escape }}

Escapes a strings HTML. Specifically, it makes these replacements:

• "&" to "&"

• < to "<"

• > to ">"

• '"' (double quote) to '"'

• "'" (single quote) to '''

first

Example:

{{ list|first }}

Returns the first item in a list.

fix_ampersands

Example:

{{ string|fix_ampersands }}

floatformat

Examples:

{{ value|floatformat }} {{ value|floatformat:"2" }}

get_digit

Example:

{{ value|get_digit:"1" }}

join

例子：

{{ list|join:", " }}

Joins a list with a string, like Pythons str.join(list) .

striptags

Example:

{{ string|striptags }}