Django模板的基本标签

最新推荐文章于 2023-06-18 21:15:50 发布

代码无常

最新推荐文章于 2023-06-18 21:15:50 发布

阅读量249

点赞数

分类专栏： Python django 文章标签： python django

庄立成

本文链接：https://blog.csdn.net/zhuanglicheng/article/details/109200761

版权

Python 同时被 2 个专栏收录

17 篇文章 0 订阅

订阅专栏

django

12 篇文章 0 订阅

订阅专栏

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 处理后的结果，它功能是转换文本为小写。

2、过滤管道可以被 套接，既是说，一个过滤器管道的输出又可以作为下一个管道的输入，如此下去。下面的例子实现查找列表的第一个元素并将其转化为大写。

3、有些过滤器有参数。

过滤器的参数跟随冒号之后并且总是以双引号包含。 {{ bio|truncatewords:"30" }} 这个将显示变量 bio 的前 30 个词。

4、其他：

addslashes：添加反斜杠到任何反斜杠、单引号或者双引号前面；

date：按指定的格式字符串参数格式化 date 或者 datetime 对象。

示例：

>>> 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'