Django 2.1.7 模板语言 - 变量、标签、过滤器、自定义过滤器、模板注释

相关篇章

Django 2.1.7 创建应用模板
Django 2.1.7 配置公共静态文件、公共模板路径

参考文献

https://docs.djangoproject.com/zh-hans/2.1/topics/templates/

模板语言

模板语言包括4种类型,分别是:

  • 变量
  • 标签
  • 过滤器
  • 注释
    接下来逐个介绍4种类型。

模板变量

模板变量的作用是计算并输出,变量名必须由字母、数字、下划线(不能以下划线开头)和点组成。

语法如下:

{{变量}}

现在来看看前面篇章中写到的模板遍历代码如下:

{% for value in info.m_query %}
<tr>
       <th scope="row">{{ value.id }}</th>
       <td>{{ info.server_name }}</td>
       <td>{{ value.name }}</td>
       <td>{{ value.port }}</td>
        <td><a href="deleteMiddlewareinfo?id={{ value.id }}" class="btn btn-outline-primary">删除</a></td>
        </tr>
{% endfor %}

当模版引擎遇到点如info.m_query,会按照下列顺序解析:
1.字典info['m_query']
2.先属性后方法,将info当作对象,查找属性m_query,如果没有再查找方法m_query()
3.如果是格式为info.0则解析为列表info[0]

如果变量不存在则插入空字符串。

在模板中调用方法时不能传递参数。

示例

1)打开assetinfo/views.py文件,创建视图temp_var。

def temp_var(request):
    dict={'title':'字典键值'}
    # 查询所有服务器的信息
    server_list = ServerInfo.objects.all()
    context={'dict':dict,'server_list':server_list}
    return render(request,'assetinfo/temp_var.html',context)

2)打开assetinfo/urls.py文件,配置url。

urlpatterns = [
    # ex:/assetinfo/temp_var
    path('temp_var', views.temp_var),
...
]

3)修改在templates/assetinfo下创建temp_var.html。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    模板变量:<br/>
    {{dict.title}}<br/>
    {% for server in server_list %}
        {{ forloop.counter }} -- {{ server.server_hostname }}<br>
    {% endfor %}

</body>
</html>

4)运行服务器,在浏览器中输入如下网址。

http://127.0.0.1:8000/assetinfo/temp_var

5)浏览效果如下图。

标签

语法如下:

{%代码段%}

for标签语法如下:

{%for item in 列表%}
循环逻辑
{{forloop.counter}}表示当前是第几次循环,从1开始
{%empty%}
列表为空或不存在时执行此逻辑
{%endfor%}

if标签语法如下:

{%if ...%}
逻辑1
{%elif ...%}
逻辑2
{%else%}
逻辑3
{%endif%}

比较运算符如下:

注意:运算符左右两侧不能紧挨变量或常量,必须有空格。

==
!=
<
>
<=
>=

布尔运算符如下:

and
or
not

示例

1)打开assetinfo/views.py文件,创建视图temp_tag。

def temp_tags(request):
    context={'list':ServerInfo.objects.all()}
    return render(request,'assetinfo/temp_tag.html',context)

2)打开assetinfo/urls.py文件,配置url。

urlpatterns = [
# ex:/assetinfo/temp_tags
    path('temp_tags', views.temp_tags),
]

3)在templates/assetinfo下创建temp_tag.html。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <ul>
        {%for item in list%}
            {%if item.id <= 2%}
                <li style="background-color: red;">{{item.server_hostname}}</li>
            {%elif item.id <= 3%}
                <li style="background-color: blue;">{{item.server_hostname}}</li>
            {%else%}
                <li style="background-color: green;">{{item.server_hostname}}</li>
            {%endif%}
        {%empty%}
            <li>对不起,没有服务器</li>
        {%endfor%}
    </ul>
</body>
</html>

4)运行服务器,在浏览器中输入如下网址。

http://127.0.0.1:8000/assetinfo/temp_tags

浏览器显示如下:

过滤器

语法如下:

  • 使用管道符号 | 来应用过滤器,用于进行计算、转换操作,可以使用在变量、标签中。
  • 如果过滤器需要参数,则使用冒号:传递参数。
变量|过滤器:参数

长度length,返回字符串包含字符的个数,或列表、元组、字典的元素个数。

默认值default,如果变量不存在时则返回默认值。

data|default:'默认值'

日期date,用于对日期类型的值进行字符串格式化,常用的格式化字符如下:

  • Y表示年,格式为4位,y表示两位的年。
  • m表示月,格式为01,02,12等。
  • d表示日, 格式为01,02等。
  • j表示日,格式为1,2等。
  • H表示时,24进制,h表示12进制的时。
  • i表示分,为0-59。
  • s表示秒,为0-59。
value|date:"Y年m月j日  H时i分s秒"

示例

1)打开assetinfo/views.py文件,创建视图temp_filter。

def temp_filter(request):
    context={'list':ServerInfo.objects.all()}
    return render(request,'assetinfo/temp_filter.html',context)

2)打开assetinfo/urls.py文件,配置url。

urlpatterns = [
    # ex:/assetinfo/temp_filter
    path('temp_filter', views.temp_filter),
]

3)在templates/assetinfo下创建temp_filter.html。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <ul>
        {%for item in list%}
            {%if item.server_hostname|length > 4%}
                <li style="background-color: darkseagreen;">
                    {{item.server_hostname}}
                    ---默认时间格式为:
                    {{item.server_shelves_date}}
                </li>
            {%elif item.server_hostname|length < 2%}
                <li style="background-color: cadetblue;">
                    {{item.server_hostname}}
                    ---默认时间格式为:
                    {{item.server_shelves_date}}
                </li>
            {%else%}
                <li style="background-color: green;">
                    {{item.server_hostname}}
                    ---格式化时间为:
                    {{item.server_shelves_date|date:"Y-m-j"}}
                </li>
            {%endif%}
            {% empty %}
                <li>对不起,没有服务器</li>
        {%endfor%}
    </ul>
</body>
</html>

4)运行服务器,在浏览器中输入如下网址。

http://127.0.0.1:8000/assetinfo/temp_filter

自定义过滤器

过滤器就是python中的函数,注册后就可以在模板中当作过滤器使用,下面以求余为例开发一个自定义过滤器mod。

示例

1)在应用中创建templatetags目录,当前示例为"assetinfo/templatetags",创建init文件,内容为空。

2)在"assetinfo/templatetags"目录下创建filters.py文件,代码如下:

#导入Library类
from django.template import Library

#创建一个Library类对象
register=Library()

#使用装饰器进行注册
@register.filter
#定义求余函数mod,将value对2求余
def mod(value):
    return value%2 == 0

3)在templates/assetinfo/temp_filter.html中,使用自定义过滤器。

  • 首先使用load标签引入模块。
{%load filters%}
  • 在遍历时根据编号判断奇偶,代码改为如下:
{%load filters%}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <ul>
        {%for item in list%}
            {%if item.id|mod == 1%}
                <li style="background-color: darkseagreen;">
                    {{ item.id|mod }}
                    {{item.server_hostname}}
                    ---默认时间格式为:
                    {{item.server_shelves_date}}
                </li>
            {%else%}
                <li style="background-color: #b3d4fc;">
                    {{ item.id|mod }}
                    {{item.server_hostname}}
                    ---格式化时间为:
                    {{item.server_shelves_date|date:"Y-m-j"}}
                </li>
            {%endif%}
            {% empty %}
                <li>对不起,没有服务器</li>
        {%endfor%}
    </ul>
</body>
</html>

4)运行服务器,浏览效果如下:

过滤器可以接收参数,将assetinfo/templatetags/filters.py中增加mod_num函数。

#使用装饰器进行注册
@register.filter
#定义求余函数mod_num,将value对num求余
def mod_num(value,num):
    return value%num

5)在templates/assetinfo/temp_filter.html中修改遍历时判断代码。

{%if item.id|mod_num:3 %}

6)运行服务器,浏览效果如下:

注释

在模板中使用如下模板注释,这段代码不会被编译,不会输出到客户端;html注释只能注释html内容,不能注释模板语言。

1)单行注释语法如下:

{#...#}

注释可以包含任何模版代码,有效的或者无效的都可以。

{# { % if foo % }bar{ % else % } #}

2)多行注释使用comment标签,语法如下:

{%comment%}
...
{%endcomment%}

推荐阅读更多精彩内容