Chinaunix首页 | 论坛 | 博客
  • 博客访问: 26268755
  • 博文数量: 2065
  • 博客积分: 10377
  • 博客等级: 上将
  • 技术积分: 21525
  • 用 户 组: 普通用户
  • 注册时间: 2008-11-04 17:50
文章分类

全部博文(2065)

文章存档

2012年(2)

2011年(19)

2010年(1160)

2009年(969)

2008年(153)

分类: Python/Ruby

2009-10-10 10:12:01

模板标签和过滤器基础
我们已经提到模板系统使用内建的标签和过滤器
这里我们看看常见的,附录6包含了完整的内建标签和过滤器,你自己熟悉那个列表来了解可以做什么是个好主意

if/else
{% if %}标签计算一个变量值,如果是“true”,即它存在、不为空并且不是false的boolean值
系统则会显示{% if %}和{% endif %}间的所有内容:

代码
  1. {% if today_is_weekend %}   
  2.     <p>Welcome to the weekend!p>  
  3. {% else %}   
  4.     <p>Get back to work.p>  
  5. {% endif %}  

{% if %}标签接受and,or或者not来测试多个变量值或者否定一个给定的变量,例如:
代码
  1. {% if athlete_list and coach_list %}   
  2.      Both athletes and coaches are available.   
  3. {% endif %}   
  4. {% if not athlete_list %}   
  5.      There are no athletes.   
  6. {% endif %}   
  7. {% if athlete_list or coach_list %}   
  8.      There are some athletes or some coaches.   
  9. {% endif %}   
  10. {% if not athlete_list or coach_list %}   
  11.      There are no athletes or there are some coaches.   
  12. {% endif %}   
  13. {% if athlete_list and not coach_list %}   
  14.      There are some athletes and absolutely no coaches.   
  15. {% endif %}  

{% if %}标签不允许同一标签里同时出现and和or,否则逻辑容易产生歧义,例如下面的标签是不合法的:
代码
  1. {% if athlete_list and coach_list or cheerleader_list %}  

如果你想结合and和or来做高级逻辑,只需使用嵌套的{% if %}标签即可:
代码
  1. {% if athlete_list %}   
  2.      {% if coach_list or cheerleader_list %}   
  3.          We have athletes, and either coaches or cheerleaders!   
  4.      {% endif %}   
  5. {% endif %}  

多次使用同一个逻辑符号是合法的:
代码
  1. {% if athlete_list or coach_list or parent_list or teacher_list %}  

没有{% elif %}标签,使用嵌套的{% if %}标签可以做到同样的事情:
代码
  1. {% if athlete_list %}   
  2.     <p>Here are the athletes: {{ athlete_list }}.p>  
  3. {% else %}   
  4.     <p>No athletes are available.p>  
  5.      {% if coach_list %}   
  6.         <p>Here are the coaches: {{ coach_list }}.p>  
  7.      {% endif %}   
  8. {% endif %}  

确认使用{% endif %}来关闭{% if %}标签,否则Django触发TemplateSyntaxError

for
{% for %}标签允许你按顺序遍历一个序列中的各个元素
Python的for语句语法为for X in Y,X是用来遍历Y的变量
每次循环模板系统都会渲染{% for %}和{% endfor %}之间的所有内容
例如,显示给定athlete_list变量来显示athlete列表:

代码
  1. <ul>  
  2. {% for athlete in athlete_list %}   
  3.     <li>{{ athlete.name }}li>  
  4. {% endfor %}   
  5. ul>  

在标签里添加reversed来反序循环列表:
代码
  1. {% for athlete in athlete_list reversed %}   
  2. ...   
  3. {% endfor %}   
  4. {% for %}标签可以嵌套:   
  5. {% for country in countries %}   
  6.     <h1>{{ country.name }}h1>  
  7.     <ul>  
  8.      {% for city in country.city_list %}   
  9.         <li>{{ city }}li>  
  10.      {% endfor %}   
  11.     ul>  
  12. {% endfor %}  

系统不支持中断循环,如果你想这样,你可以改变你想遍历的变量来使得变量只包含你想遍历的值
类似的,系统也不支持continue语句,本章后面的“哲学和限制”会解释设计的原则
{% for %}标签内置了一个forloop模板变量,这个变量含有一些属性可以提供给你一些关于循环的信息
1,forloop.counter表示循环的次数,它从1开始计数,第一次循环设为1,例如:
代码
  1. {% for item in todo_list %}   
  2.     <p>{{ forloop.counter }}: {{ item }}p>  
  3. {% endfor %}  

2,forloop.counter0类似于forloop.counter,但它是从0开始计数,第一次循环设为0
3,forloop.revcounter表示循环中剩下的items数量,第一次循环时设为items总数,最后一次设为1
4,forloop.revcounter0类似于forloop.revcounter,但它是表示的数量少一个,即最后一次循环时设为0
5,forloop.first当第一次循环时值为True,在特别情况下很有用:
代码
  1. {% for object in objects %}   
  2.      {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}   
  3.      {{ object }}   
  4.     li>  
  5. {% endfor %}  

6,forloop.last当最后一次循环时值为True
代码
  1. {% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}  

7,forloop.parentloop在嵌套循环中表示父循环的forloop:
代码
  1. {% for country in countries %}   
  2.     <table>  
  3.      {% for city in country.city_list %}   
  4.         <tr>  
  5.             <td>Country #{{ forloop.parentloop.counter }} td>  
  6.             <td>City #{{ forloop.counter }}td>  
  7.             <td>{{ city }}td>  
  8.         tr>  
  9.      {% endfor %}   
  10.     table>  
  11. {% endfor %}  

富有魔力的forloop变量只能在循环中得到,当模板解析器到达{% endfor %}时forloop就消失了
如果你的模板context已经包含一个叫forloop的变量,Django会用{% for %}标签替代它
Django会在for标签的块中覆盖你定义的forloop变量的值
在其他非循环的地方,你的forloop变量仍然可用
我们建议模板变量不要使用forloop,如果你需要这样做来访问你自定义的forloop,你可以使用forloop.parentloop

ifequal/ifnotequal
Django模板系统并不是一个严格意义上的编程语言,所以它并不允许我们执行Python语句
(我们会在‘哲学和限制‘一节详细讨论)。
然而在模板语言里比较两个值并且在他们一致的时候显示一些内容,确实是一个在常见不过的需求了——所以Django提供了ifequal标签。
{% ifequal %}比较两个值,如果相等,则显示{% ifequal %}和{% endifequal %}之间的所有内容:

代码
  1. {% ifequal user currentuser %}   
  2.     <h1>Welcome!h1>  
  3. {% endifequal %}  

参数可以是硬编码的string,单引号和双引号均可,下面的代码是合法的:
代码
  1. {% ifequal section 'sitenews' %}   
  2.     <h1>Site Newsh1>  
  3. {% endifequal %}   
  4. {% ifequal section "community" %}   
  5.     <h1>Communityh1>  
  6. {% endifequal %}  

和{% if %}一样,{% ifequal %}标签支持{% else %}
代码
  1. {% ifequal section 'sitenews' %}   
  2.     <h1>Site Newsh1>  
  3. {% else %}   
  4.     <h1>No News Hereh1>  
  5. {% endifequal %}  

其它的模板变量,strings,integers和小数都可以作为{% ifequal %}的参数:
代码
  1. {% ifequal variable 1 %}   
  2. {% ifequal variable 1.23 %}   
  3. {% ifequal variable 'foo' %}   
  4. {% ifequal variable "foo" %}  

其它的Python类型,如字典、列表或booleans不能硬编码在{% ifequal %}里面,下面是不合法的:
代码
  1. {% ifequal variable True %}   
  2. {% ifequal variable [1, 2, 3,]%}   
  3. {% ifequal variable {'key': 'value'} %  

如果你需要测试某个变量是true或false,用{% if %}即可

注释
和HTML或编程语言如Python一样,Django模板语言允许注释{# #},如:

代码
  1. {# This is a comment #}  

模板渲染时注释不会输出,一个注释不能分成多行
下面的模板渲染时会和模板中的内容一样,注释标签不会解析成注释
This is a {# comment goes here
and spans another line #}
test.

过滤器
本章前面提到,模板过滤器是变量显示前转换它们的值的方式,看起来像下面这样:

代码
  1. {{ name|lower }}  

这将显示通过lower过滤器过滤后{{ name }}变量的值,它将文本转换成小写
使用(|)管道来申请一个过滤器
过滤器可以串成链,即一个过滤器的结果可以传向下一个
下面是escape文本内容然后把换行转换成p标签的习惯用法:
代码
  1. {{ my_text|escape|linebreaks }}  

有些过滤器需要参数,需要参数的过滤器的样子:
代码
  1. {{ bio|truncatewords:"30" }}  

这将显示bio标量的前30个字,过滤器参数一直使用双引号
下面是一些最重要的过滤器:
1,addslashed,在任何后斜线,单引号,双引号前添加一个后斜线
当你把一些文本输出到一个JavaScript字符串时这会十分有用
2,date,根据一个格式化string参数来格式化date或datetime对象,例如:
代码
  1. {{ pub_date|date:"F j, Y" }}  

格式化string会在附录6定义
3,escape,避免给定的string里出现and符,引号,尖括号
当你处理用户提交的数据和确认合法的XML和XHTML数据时这将很有用
escape将作如下的一些转换:
代码
  1. Converts & to &   
  2. Converts < to <   
  3. Converts > to >   
  4. Converts "(双引号) to "   
  5. Converts '(单引号) to &#39;   

4,length,返回值的长度,你可以在一个list或string上做此操作
或者在任何知道怎样决定自己的长度的Python对象上做此操作(即有一个__len__()方法的对象)
阅读(862) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~