block

定义一个能被�模�覆盖的区�。��第四章“模�继承�一节查看更多信�。

comment

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

cycle

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

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

{% for o in some_list %}
    <tr class="{% cycle row1,row2 %}">
        ...
    </tr>
{% endfor %}

在循环外，在你第一次调用时，给这些字符串值定义一个���的�字，以��次�需使用这个�字就行了：

<tr class="{% cycle row1,row2,row3 as rowcolors %}">...</tr>
<tr class="{% cycle rowcolors %}">...</tr>
<tr class="{% cycle rowcolors %}">...</tr>

你�以使用任�数�的用逗�分隔的值。注���在值与值之间有空格，�是一个逗�。

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 ：

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% endfor %}
</ul>

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

for 循环设置了许多循环中�用的��（�表F-1）。

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 �测试��或者对给定的����：

{% if athlete_list and coach_list %}
    Both athletes and coaches are available.
{% endif %}

{% if not athlete_list %}
    There are no athletes.
{% endif %}

{% if athlete_list or coach_list %}
    There are some athletes or some coaches.
{% endif %}

{% if not athlete_list or coach_list %}
    There are no athletes or there are some coaches (OK, so
    writing English translations of Boolean logic sounds
    stupid; it's not our fault).
{% endif %}

{% if athlete_list and not coach_list %}
    There are some athletes and absolutely no coaches.
{% endif %}

��许 and 和 or �时出现在一个 if 语�中，因为这样会有逻辑上的问题。例如这样是有语病的：

{% if athlete_list and coach_list or cheerleader_list %}

如果你需��时使用 and 和 or �实现较高级的逻辑，�以用嵌套的 if 标签�实现。例如：

{% if athlete_list %}
    {% if coach_list or cheerleader_list %}
        We have athletes, and either coaches or cheerleaders!
    {% endif %}
{% endif %}

��使用�一逻辑符是�以的。例如这样是正确的：

{% if athlete_list or coach_list or parent_list or teacher_list %}

ifchanged

检查循环中一个值从最近一次��其是�改�。

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

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

<h1>Archive for {{ year }}</h1>

{% for date in days %}
    {% ifchanged %}<h3>{{ date|date:"F" }}</h3>{% endifchanged %}
    <a href="{{ date|date:"M/d"|lower }}/">{{ date|date:"j" }}</a>
{% endfor %}

如果给的是一个��，就会检查它是��生改�。

{% for date in days %}
    {% ifchanged date.date %} {{ date.date }} {% endifchanged %}
    {% ifchanged date.hour date.date %}
        {{ date.hour }}
    {% endifchanged %}
{% endfor %}

��那个例�中日期�次�生�化时就会显示出�，但�有�时和日期都�生�化时�会显示�时。

ifequal

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

举个例�：

{% ifequal user.id comment.user_id %}
    ...
{% endifequal %}

正如 {% if %} 标签一样， {% else %} 语�是�选的。

�数也�以是硬编�的字符串，所以下�这�写法是正确的：

{% ifequal user.username "adrian" %}
    ...
{% endifequal %}

�以用�比较的�数��于模���或者字符串（实际上整数和�数也是�以的——译注），你�能检查诸如 True or False 等Python对象是�相等。如果你需�测试�值的真�，�以用 if 标签。

ifnotequal

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

include

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

模���以是一个��或者是一个硬编�（引�引起�的）的字符串，引��以是�引�或者�引�。

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

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

这个例�包�了�字由�� template_name 指定的模�的内容：

{% include template_name %}

load

读入一个自定义的模�库。第�章里有关于自定义模�的相关信�资料

now

根�给定的格�字符串显示当�日期。

这个标签��于PHP中的 date() 函数（ http://php.net/date ），并使用与其相�的格�语法，但是Django对其�了扩展。

表F-2显示了�用的格�字符串。

看这个例�：

It is {% now "jS F Y H:i" %}

记�，如果你想用一个字符串的原始值的�，你�以用�斜线进行转义。在这个例�中，f被用�斜线转义了，如果�转义的�f就是显示时间的格�字符串。o�用转义，因为它本�就�是一个格�字�。

It is the {% now "jS o\f F" %}

这样就会显示�“It is the 4th of September�。

regroup

把一列相似的对象根��一个共有的属性�新分组。

�解释清这个��的标签，最好�举个例�。比如， people 是包� Person 对象的一个列表， 这个对象拥有 first_name � last_name 和 gender 属性，你想这样显示这个列表：

* Male:
    * George Bush
    * Bill Clinton
* Female:
    * Margaret Thatcher
    * Condoleezza Rice
* Unknown:
    * Pat Smith

下�这段模�代�就�以完�这个看起�很��的任务：

{% regroup people by gender as grouped %}
<ul>
{% for group in grouped %}
    <li>{{ group.grouper }}
    <ul>
        {% for item in group.list %}
        <li>{{ item }}</li>
        {% endfor %}
    </ul>
    </li>
{% endfor %}
</ul>

如你所�， {% regroup %} 构造了一个列表��，列表中的�个对象都有 grouper 和 list 属性。 grouper 包�分组所��的属性， list 包�一系列拥有共�的 grouper 属性的对象。这样 grouper 就会是 Male � Female 和 Unknown ， list 就是属于这几�性别的人们。

记�，如果被分组的列表�是按照�一列排好�的�，你就�能用 {% regroup %} 在这一列上进行�新分组�就是说如果人的列表�是按照性别排好�的�，在用它之�就�先对它排�，�：

{% regroup people|dictsort:"gender" by gender as grouped %}

spaceless

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

例如：

{% spaceless %}
    <p>
        <a href="foo/">Foo</a>
    </p>
{% endspaceless %}

返回结果如下：

<p><a href="foo/">Foo</a></p>

仅仅 标签 之间的空白符被删掉，标签和文本之间的空白符是�会被处�的。在下�这个例�中， Hello 两边的空白符是�会被截掉的：

{% spaceless %}
    <strong>
        Hello
    </strong>
{% endspaceless %}

ssi

把一个指定的文件的内容输出到页�上。

�include标签一样， {% ssi %} 会包��外一个文件的内容，这个文件必须以�对路径指明：

{% ssi /home/html/ljworld.com/includes/right_generic.html %}

如果指定了�选的parsed�数的�，包�进�的文件的内容会被当作模�代�，并用当�的上下文�渲染：

{% ssi /home/html/ljworld.com/includes/right_generic.html parsed %}

注�，如果你�使用 {% ssi %} 的�，为了安全起�，你必须在Django�置文件中定义ALLOWED_INCLUDE_ROOTS。

大多数情况下 {% include %} 比 {% ssi %} 更好用， {% ssi %} 的存在通常是为了��兼容。

templatetag

输出组�模�标签的语法字符。

模�系统没有转义的概念，所以�显示一个组�模�标签的字符的�，你必须使用 {% templatetag %} 标签。

�数用�标明�显示的字符（��表F-3）。

url

根�所给视图函数和�选�数，返回一个�对的URL（就是�带域�的URL）。由于没有在模�中对URL进行硬编�，所以这�输出链接的方法没有��DRY原则。

{% url path.to.some_view arg1,arg2,name1=value1 %}

第一个��是按package.package.module.function形�给出的指�一个view函数的路径。那些�选的�用逗�分隔的附加�数被用�URL中的�置和关键���。所有URLconf需�的�数都应该是存在的。

例如，�设你有一个view，app_name.client，它的URLconf包�一个client ID�数。URLconf对应行�能看起��这样：

('^client/(\d+)/$', 'app_name.client')

如果这个应用的URLconf�下�一样被包�在项目的URLconf里：

('^clients/', include('project_name.app_name.urls'))

那么，在模�中，你�以�这样创建一个指�那个view的link连接：

{% url app_name.client client.id %}

模�标签将输出字符串/clients/client/123/

widthratio，寬度的比率

為了畫出長�圖，這個標籤計算一個給定值相�於最大值的比率，然後將這個比率給定一個常數

一些实例：

<img src="bar.gif" height="10" width="{% widthratio this_value max_value 100 %}" />

If this_value is 175 and max_value is 200, the image in the preceding example will be 88 pixels wide (because 175/200 = .875; .875 * 100 = 87.5, which is rounded up to 88).

add

例如：

{{ value|add:"5" }}

�数与被处�数�相加的结果.

addslashes

例如：

{{ string|addslashes }}

给�感字符添加斜线(转义). 举例,�将一个字符串传递给 JavaScript 时.

capfirst

例如：

{{ string|capfirst }}

将字符串的首字�大写

center

例如：

{{ string|center:"50" }}

在一个给定的长度让字符串居中

cut

例如：

{{ string|cut:"spam" }}

把给定字符串中包�的所有�数值删除掉。

date

Example:

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

把一个date类型按照给定的格å¼�输出（与”now”标签用法一样）。

default

例如：

{{ value|default:"(N/A)" }}

如果���存在，使用默认值

default_if_none

例如：

{{ value|default_if_none:"(N/A)" }}

如果��值为None，使用默认值

dictsort

例如：

{{ list|dictsort:"foo" }}

接�一个字典列表,返回按给定�数的属性排��的列表.

dictsortreversed

例�:

{{ list|dictsortreversed:"foo" }}

接�一个字典列表,返回按给定�数的属性逆�排��的列表

divisibleby

Example:

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

如果值能够被给定的�数整除的�，返回“True�。

escape

例如：

{{ string|escape }}

按照以下的规则，转义一个HTML字符串：

• "&" to "&"

• < to "&lt;"

• > to "&gt;"

• '"' (double quote) to '&quot;'

• "'" (single quote) to '&#39;'

filesizeformat

Example:

{{ value|filesizeformat }}

将值格å¼�化为 ‘å�¯è¯»æ€§å¥½çš„’ 文件大å°�(比如 ‘13 KB’, ‘4.1 MB’, ‘102bytes’ 等等).

first

Example:

{{ list|first }}

返回列表中的第一个元素.

fix_ampersands

Example:

{{ string|fix_ampersands }}

将 & 符�替�为 &amp; 实体

floatformat

Examples:

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

将一个浮点数四èˆ�五入到å°�数点å�Ž1ä½� — 如果根本没有å°�æ•°,å°�数部分ä¸�会显示.

• 36.123 gets converted to 36.1 .

• 36.15 gets converted to 36.2 .

• 36 gets converted to 36 .

如果使用�一个数字的整数�数，“floatformat�轮数， 许多�数�：

• 36.1234 with floatformat:3 gets converted to 36.123 .

• 36 with floatformat:4 gets converted to 36.0000 .

If the argument passed to floatformat is negative, it will round a number to that many decimal places but only if theres a decimal part to be displayed:

• 36.1234 with floatformat:-3 gets converted to 36.123 .

• 36 with floatformat:-4 gets converted to 36 .

Using floatformat with no argument is equivalent to using floatformat with an argument of -1 .

get_digit

Example:

{{ value|get_digit:"1" }}

�供一个完整的数, 返回该数中被请求的数字,其中 1 是最�边的数, 2 是从�边数第二个数字等等. 若输入值�法(若输入或�数�是整数, 或者�数�于1)则返回其原始值. �则输出就总是整数.

join

例�：

{{ list|join:", " }}

用一个字符串将一个列表连接起�,类似 Python 的 str.join(list).

length

例�：

{{ list|length }}

返回对象的长度

length_is

Example:

{% if list|length_is:"3" %}
    ...
{% endif %}

若值的长度与�数相等,返回 True, �则返回 False.

linebreaks

Example:

{{ string|linebreaks }}

把�行符转��<p>和<br />标签。

linebreaksbr

Example:

{{ string|linebreaksbr }}

把æ¯�个新行转æ�¢ä¸º”<br />”标签

linenumbers

Example:

{{ string|linenumbers }}

带行�显示文本

ljust

Example:

{{ string|ljust:"50" }}

在给定宽度的域内将文本左对�.

lower

Example:

{{ string|lower }}

把一个给定的字符串转���写。

make_list

Example:

{% for i in number|make_list %}
    ...
{% endfor %}

将值转化为一个列表.对一个整数,它是一个数字的列表.对一个字符串,这是一个字符的列表

phone2numeric

Example:

{{ string|phone2numeric }}

将一个电è¯�å�·ç �(å�¯èƒ½åŒ…å�«å­—æ¯�)转化等价的数字值.比如: ‘800-COLLECT’ 将被转化为 ‘800-2655328’.

输入�一定�是一个�法��. 它�以转化任�字符串.

pluralize

Example:

The list has {{ list|length }} item{{ list|pluralize }}.

如果值ä¸�是 1 çš„è¯�返回 ‘s’ 用于 ‘1 vote’ vs. ‘2 votes’ è¿™ç§�场å�ˆ

Example:

You have {{ num_messages }} message{{ num_messages|pluralize }}.

For words that require a suffix other than 's' , you can provide an alternate suffix as a parameter to the filter.

Example:

You have {{ num_walruses }} walrus{{ num_walrus|pluralize:"es" }}.

For words that dont pluralize by simple suffix, you can specify both a singular and plural suffix, separated by a comma.

Example:

You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.

pprint

Example:

{{ object|pprint }}

pprint.pprint 和一个å°�装器— 仅用于调试.

random

Example:

{{ list|random }}

返回�机的从列表中返回一个元素

removetags

Example:

{{ string|removetags:"br p div" }}

从输出中删除�空格分隔的 [X]HTML标签 列表

rjust

Example:

{{ string|rjust:"50" }}

在给定宽度的域内将文本�对�.

slice

Example:

{{ some_list|slice:":2" }}

返回一个列表的片段

使用与 Python 的 list 相�的语法, �阅 http://diveintopython.org/native_data_types/lists.html#odbchelper.list.slice 以了解更详细的信�.

slugify

Example:

{{ string|slugify }}

转化为�写, 移去���字符(字�数字和下划线),将空白转化为连字符,去除��空白.

stringformat

Example:

{{ number|stringformat:"02i" }}

æ ¹æ�®ç»™å®šå�‚æ•°(一个格å¼�字符串)æ ¼å¼�化一个å�˜é‡�, 这个格å¼�字符串使用 Python 字符串格å¼�化语法, 例外之处是 “%” è¿�算符被çœ�ç•¥.

�阅 http://docs.python.org/lib/typesseq-strings.html 以了解 Python 格�字符串

striptags

Example:

{{ string|striptags }}

过滤掉[X]HTML标签.

time

Example:

{{ value|time:"P" }}

按指定的样�（样�定义�now标签）�格�化一个时间对象

timesince

Examples:

{{ datetime|timesince }}
{{ datetime|timesince:"other_datetime" }}

æ ¼å¼�化一个日期,这个日期是从给定日期到现在的天数和å°�时数(比如: “4 days, 6 hours”).

接å�—一个å�¯é€‰çš„å�‚数，该å�‚数是一个包å�«æ¯”较日期的å�˜é‡�（该å�‚数默认值是 now). 举例æ�¥è¯´ï¼Œ 如果 blog_date 是一个日期实例表示 2006-06-01 å�ˆå¤œï¼Œ 而 comment_date 是一个日期实例表示 2006-06-01 早上8点，那么 {{ comment_date|timesince:blog_date }} 将返回 “8 hours”.

timeuntil

Examples:

{{ datetime|timeuntil }}
{{ datetime|timeuntil:"other_datetime" }}

类似 timesince, å�ªæ˜¯å®ƒæ¯”较当å‰�时间直到给定日期时间。举例æ�¥è¯´ï¼Œå¦‚果今天是 2006-06-01 而 conference_date 是 2006-06-29, 那么 {{ conference_date|timeuntil }} 将返回 “28 days”.

接å�—一个å�¯é€‰çš„å�‚数，该å�‚数是一个包å�«æ¯”较日期的å�˜é‡�（该å�‚数默认值是 now). 举例æ�¥è¯´ï¼Œ 如果 from_date 是一个日期实例表示 2006-06-22， 那么 {{ conference_date|timeuntil:from_date }} 会返回 “7 days”.

title

Example:

{{ string|titlecase }}

按标题格�转化一个字符串

truncatewords

Example:

{{ string|truncatewords:"15" }}

将一个字符串截短为指定数目的��.

truncatewords_html

Example:

{{ string|truncatewords_html:"15" }}

Similar to truncatewords , except that it is aware of HTML tags. Any tags that are opened in the string and not closed before the truncation point are closed immediately after the truncation.

This is less efficient than truncatewords , so it should be used only when it is being passed HTML text.

unordered_list

Example:

<ul>
    {{ list|unordered_list }}
</ul>

递归的接å�—一个自嵌套的列表并返回一个HTMLæ— åº�列表(此列表å�¯ä¸�是pythob语义中的列表) — å�ªæ˜¯æ²¡æœ‰å¼€å§‹å’Œç»“æ�Ÿçš„<ul>标签

å�‡å®šè¯¥åˆ—表是å�ˆé€‚çš„æ ¼å¼�. 举例æ�¥è¯´, 如果 var 的值为 [‘States’, [[‘Kansas’, [[‘Lawrence’, []], [‘Topeka’, []]]], [‘Illinois’, []]]], 那么 {{ var|unordered_list }} 就会返回:

<li>States
<ul>
        <li>Kansas
        <ul>
                <li>Lawrence</li>
                <li>Topeka</li>
        </ul>
        </li>
        <li>Illinois</li>
</ul>
</li>

upper

例�：

{{ string|upper }}

将一个字符串全部字�改为大写。

urlencode

例�：

<a href="{{ link|urlencode }}">linkage</a>

转义该值以用于 URL.

urlize

例�：

{{ string|urlize }}

将URLs由纯文本�为�点击的链接。

urlizetrunc

例�：

{{ string|urlizetrunc:"30" }}

将URLs�为�点击的链接，按给定字��截短URLs。

wordcount

例如：

{{ string|wordcount }}

返回��数。

wordwrap

例如：

{{ string|wordwrap:"75" }}

在指定长度将文字�行。

yesno

例如：

{{ boolean|yesno:"Yes,No,Perhaps" }}

�供一个字符串�数对应� true, false 和 (�选的) None, 根�被处�的值返回相应的字符串: