一、if/else
1、{% if %} 标签检查(evaluate)一个变量,如果这个变量为真(即,变量存在,非空,不是布尔值假),系统会显示在 {% if %} 和 {% endif %} 之间的任何内容,例如:
{% if today_is_weekend %} <p>Welcome to the weekend!</p> {% endif %}{% else %} 标签是可选的:
{% if today_is_weekend %} <p>Welcome to the weekend!</p> {% else %} <p>Get back to work.</p> {% endif %}在 Python 和 Django 模板系统中,以下这些对象相当于布尔值的 False(其
余均视为 True)
空列表:[]
空元组:()
空字典:{}
空字符串:''
零值:0
特殊对象:None
对象:False
提示:你也可以在自定义的对象里定义他们的布尔值属性(这个是 python 的
高级用法)。
2、{% if %}标签接受 and,or 或者 not 关键字来对多个变量做判断,或者对变量取反 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. {% endif %} {% if athlete_list and not coach_list %} There are some athletes and absolutely no coaches. {% endif %}3、{% if %}标签不允许在同一个标签中同时使用 and 和 or,因为逻辑上可能模糊的,例如,如下示例是错误的:
{% if athlete_list and coach_list or cheerleader_list %}
4、系统不支持用圆括号来组合比较操作。如果你确实需要用到圆括号来组合表达你的逻辑,考虑将它移到模板之外处理,然后以模板变量的形式传入结果。或者,仅仅用嵌套的{% if %}标签替换,就像这样:
{% if athlete_list %} {% if coach_list or cheerleader_list %} We have athletes, and either coaches or cheerleaders! {% endif %} {% endif %}5、多次使用同一个逻辑操作符是没有问题的,但是我们不能把不同的操作符组合起来。例如,这是合法的:
{% if athlete_list or coach_list or parent_list or teacher_list %}6、并没有{% elif %}标签,请使用嵌套的{% if %}标签来达成同样的效果:
{% if athlete_list %} <p>Here are the athletes: {{ athlete_list }}.</p> {% else %} <p>No athletes are available.</p> {% if coach_list %} <p>Here are the coaches: {{ coach_list }}.</p> {% endif %} {% endif %}一定要用{% endif %}关闭每一个{% if %}标签。
二、for
1、{% for %}允许我们在一个序列上迭代。与 Python 的 for 语句的情形类似,循环语法是 for X in Y,Y 是要迭代的序列而 X 是在每一个特定的循环中使用的变量名称。每一次循环中,模板系统会渲染在{% for %}和{% endfor %}之间的所有内容。
例如,给定一个运动员列表 athlete_list 变量,我们可以使用下面的代码来显示这个列表:
<ul> {% for athlete in athlete_list %} <li>{{ athlete.name }}</li> {% endfor %} </ul>2、给标签增加一个 reversed 使得该列表被反向迭代:
{% for athlete in athlete_list reversed %} ... {% endfor %}3、可以嵌套使用 {% for %} 标签:
{% for athlete in athlete_list %} <h1>{{ athlete.name }}</h1> <ul> {% for sport in athlete.sports_played %} <li>{{ sport }}</li> {% endfor %} </ul> {% endfor %}4、在执行循环之前先检测列表的大小是一个通常的做法,当列表为空时输出一些特别的提示。
{% if athlete_list %} {% for athlete in athlete_list %} <p>{{ athlete.name }}</p> {% endfor %} {% else %} <p>There are no athletes. Only computer programmers.</p> {% endif %}因为这种做法十分常见,所以 for 标签支持一个可选的{% empty %}分句,
通过它我们可以定义当列表为空时的输出内容 下面的例子与之前那个等价:
{% for athlete in athlete_list %} <p>{{ athlete.name }}</p> {% empty %} <p>There are no athletes. Only computer programmers.</p> {% endfor %}5、Django 不支持退出循环操作。如果想退出循环,可以改变正在迭代的变量,让其仅仅包含需要迭代的项目。同理,Django 也不支持 continue 语句,无法让当前迭代操作跳回到循环头部。
6、每个{% for %}循环里有一个称为 forloop 的模板变量。这个变量有一些提示循环进度信息的属性。
forloop.counter 总是一个表示当前循环的执行次数的整数计数器。这个计数器是从 1 开始的,所以在第一次循环时 forloop.counter 将会被设置为 1 forloop.counter0 类似于 forloop.counter,但是它是从 0 计数的。第一次执行循环时这个变量会被设置为 0。 {% for item in todo_list %} <p>{{ forloop.counter }}: {{ item }}</p> {% endfor %} forloop.revcounter 是表示循环中剩余项的整型变量。在循环初次执行时forloop.revcounter 将被设置为序列中项的总数。最后一次循环执行中,这个变量将被置 1。 forloop.revcounter0 类似于 forloop.revcounter,但它以 0 做为结束索引。在第一次执行循环时,该变量会被置为序列的项的个数减 1。 forloop.first 是一个布尔值,如果该迭代是第一次执行,那么它被置为 True。 {% for object in objects %} {% if forloop.first %} <li class="first"> {% else %} <li> {% endif %} {{ object }} </li> {% endfor %} forloop.last 是一个布尔值;在最后一次执行循环时被置为 True。一个常见的用法是在一系列的链接之间放置管道符(|) {% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}上面的模板可能会产生如下的结果: Link1 | Link2 | Link3 | Link4 另一个常见的用途是为列表的每个单词的加上逗号。
{% for p in places %}{{ p }}{% if not forloop.last %}, {% endif %}{% endfor %} forloop.parentloop是一个指向当前循环的上一级循环的forloop对象的引用(在嵌套循环的情况下)。 {% for country in countries %} <table> {% for city in country.city_list %} <tr> <td>Country #{{ forloop.parentloop.counter }}</td> <td>City #{{ forloop.counter }}</td> <td>{{ city }}</td> </tr> {% endfor %} </table> {% endfor %} forloop 变量仅仅能够在循环中使用。在模板解析器碰到{% endfor %}标签后,forloop 就不可访问了。三、 ifequal/ifnotequal
Django 模板系统压根儿就没想过实现一个全功能的编程语言,所以它不允许我们在模板中执行 Python 的语句。但是比较两个变量的值并且显示一些结果实在是个太常见的需求了,所以 Django 提供了{% ifequal %}标签供我们使用。
{% ifequal %}标签比较两个值,当他们相等时,显示在{% ifequal %}和{% endifequal %}之中所有的值。
下面的例子比较两个模板变量 user 和 currentuser:
{% ifequal user currentuser %} <h1>Welcome!</h1> {% endifequal %}参数可以是硬编码的字符串,随便用单引号或者双引号引起来,所以下列代码都是正确的:
{% ifequal section 'sitenews' %} <h1>Site News</h1> {% endifequal %} {% ifequal section "community" %} <h1>Community</h1> {% endifequal %}和{% if %}类似,{% ifequal %}支持可选的{% else%}标签:
{% ifequal section 'sitenews' %} <h1>Site News</h1> {% else %} <h1>No News Here</h1> {% endifequal %}只有模板变量、字符串、整数和小数可以作为{% ifequal %}标签的参数。
下面是合法参数的例子:
{% ifequal variable 1 %} {% ifequal variable 1.23 %} {% ifequal variable 'foo' %} {% ifequal variable "foo" %}其他任何类型,例如 Python 的字典类型、列表类型、布尔类型,不能用在{% ifequal %}中。下面是些错误的例子:
{% ifequal variable True %} {% ifequal variable [1, 2, 3] %} {% ifequal variable {'key': 'value'} %}四、注释
1、单行注释:{# #}
{# This is a comment #}注释的内容不会在模板渲染时输出。
用这种语法的注释不能跨越多行。这个限制是为了提高模板解析的性能。
在下面这个模板中,输出结果和模板本身是完全一样的(也就是说,注释标签并没有被解析为注释):
This is a {# this is not a comment #} test.2、多行注释:{% comment %} 模板标签
{% comment %} This is a multi-line comment. 如果是单行注释换行之后会报错 {% endcomment %}五、基本过滤器
模板过滤器是在变量被显示前修改它的值的一个简单方法。
1、过滤器使用管道字符,如下所示:
{{ name|lower }}
显示的内容是变量 {{ name }} 被过滤器 lower 处理后的结果,它功能是转换文本为小写。
2、过滤管道可以被 套接 ,既是说,一个过滤器管道的输出又可以作为下一个管道的输入,如此下去。下面的例子实现查找列表的第一个元素并将其转化为大写。
{{ my_list|first|upper }}
3、有些过滤器有参数。
过滤器的参数跟随冒号之后并且总是以双引号包含。 {{ bio|truncatewords:"30" }} 这个将显示变量 bio 的前 30 个词。
4、其他:
addslashes:添加反斜杠到任何反斜杠、单引号或者双引号前面;
date:按指定的格式字符串参数格式化 date 或者 datetime 对象。
{{ pub_date|date:"F j, Y" }}
示例:
>>> from django.template import Context, Template >>> import datetime >>> d = datetime.date(2009, 4, 2) >>> t = Template('{{ pub_date|date:"F j, Y" }}') >>> c = Context({'pub_date': d}) >>> t.render(c) 'April 2, 2009'