Django模板的基本标签

it2024-07-23  41

Django模板的基本标签

一、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'
最新回复(0)