首页 > Django中文参考-

Django中文参考-

发布时间：来源：文档文库

小中大

字号：

手机查看

django 内建标签和过滤器参考

下面的标签和过滤器参考就是为那些没有 admin 站点的可用的人准备的.由于 Django 是高度可定制的,你的 admin 里的关于标签和过滤器的参考可以认为是最可信的. 内建标签参考
block  定义一个能被子模板覆盖的块. 参阅模板继承了解更多信息
comment  注释.模板引擎会忽略掉 {% comment %} 和 {% endcomment %} 之间的所有内容. cycle  在循环时轮流使用给定的字符串列表中的值. 在一个循环中, 在循环过程中的每次循环里轮流使用给定的字符串列表元素: {% for o in some_list %} ... {% endfor %} 在循环之外, 在你第一次调用它时给这些字符串值定义一个不重复的名字,然后在循环中使用这个名字: ... ... ... 你可以使用任意数量的逗号分隔的值.只有一点请你注意,不要在值与值之间放任何空隔--仅仅只有一个逗号即可.
debug 输出完整的调试信息,包括当前的上下文及导入的模块信息. extends 当前模板扩展父模板的一个信号(标记. 这个标签有两种使用方式: {% extends "base.html" %} (带双引号使用 "base" 作为要扩展的父模板的名字.或者 {%
extends variable %} 使用 variable 的值作为要扩展的父模板的名字. 参阅模板继承以了解更多信息. filter 用来过滤变量的值. 允许多级过滤, 并且他们可以带有参数运行 -- just like in variable syntax. 示例: {% filter escape|lower %} 文本将被 HTML-转义, 并且全部转化为小写 {% end过滤器 %} 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 %}

{% endfor %}

通过使用 {% for obj in list reversed %} 你也可以实现反序循环. 在循环过程中 for 循环会设置以下的一系列变量:

Variable forloop.counter forloop.counter0 forloop.revcounter forloop.revcounter0 forloop.first Description 当前循环次数 (1-indexed 当前循环次数
(0-indexed 倒序循环时当前循环次数(1-indexed 倒序循环时当前循环次数(0-indexed 如果当前循环是循环过程的第一次则为True 如果当前循环是循环过程的最后一次则为True 对嵌套循环, 当前循环之上的循环
forloop.last forloop.parentloop
if {% if %} 标签对一个变量求值, 若这个变量为 "true" , 就输出 if 内容块: {% if athlete_list %} Number of athletes: {{ athlete_list|length }} {% else %} No athletes. {% endif %} 在上例中, 如果 athlete_list 非空, 运动员人数就会通过 {{ athlete_list|length }} 变
量显示出来. 就象你刚刚看到的, if 标签可以带一个 {% else %} 子句,用来当 if 测试失败后输出相应的内容块. 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 %} 为避免造成歧义, if``标签不允许在一个 tag 中同时有 ``and 和 or 逻辑; 举个例子，下面这个语句不能工作: {% if athlete_list and coach_list or other_list %} 如果确实需要组合条件，可以使用嵌套的 if 实现相同的功能:
{% if athlete_list %}
{% if coach_list or other_list %} We have athletes and , either coaches or others. {% endif %} {% endif %} ifchanged 检查一个变量自上次循环之后是否发生了改变.(我的理解:主要用于过滤掉重复的值 'ifchanged' block标签用于循环中. 它根据自身上次的状态检查自己值, 只有值发生变化时才显示这个值:

Archive for {{ year }}

{% for day in days %} {% ifchanged %}

{% endifchanged %} {{ day|date:"j" }} {% endfor %} ifequal 若两个参数相等,输出一个内容块. 例子: {% ifequal user.id comment.user_id %}
... {% endifequal %} 如同 {% if %} tag, 它也支持一个可选的 {% else %} 子句. 参数可以是变量,也可以是字符串字面值, 也就是说下面这样也是合法的: {% ifequal user.username "adrian" %}
... {% endifequal %} ifnotequal 类似 ifequal, 只是它用来测试两个参数是否不等. include
载入一个模板并根据当前上下文渲染它.用于在一个模板中包含其它模板. 模板名字可以是一个变量,也可以是一个字符串(带引号的字符串,无所谓单引号还是双引号. 下面这个例子包含了 "foo/bar.html" 模板的内容: {% include "foo/bar.html" %} 下面这个例子包含了另一个模板(该模板的名字为变量 template_name 的值的内容: {% include template_name %} 被包含的模板使用包含它的模板的上下文(也就是环境进行渲染(求值,下面这个例子输出
"Hello, John": Context: variable person is set to "john".
Template: {% include "name_snippet.html" %} The name_snippet.html template: Hello, {{ person }} 参阅: {% ssi %}. load 装入一个自定义模板标签集. 参阅自定义标签及过滤器库以了解更多信息. now 显示当前日期, 根据给定的字符串决定输出格式. 使用和 PHP 的 date( 函数一样的格式码 (http://php.net/date