Django模板过滤器和标签入门

最新推荐文章于 2024-07-13 02:10:59 发布

grfstc

最新推荐文章于 2024-07-13 02:10:59 发布

阅读量378

点赞数

分类专栏： Django 文章标签： django

本文链接：https://blog.csdn.net/grfstc/article/details/124925527

版权

Django 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

如何安装环境和创建Django项目可参考Django安装_grfstc的博客-CSDN博客

之前转载的过滤器总结文档Django框架下的html模板过滤器_grfstc的博客-CSDN博客

可参考Liquid过滤器简介 – Liquid 模板语言中文文档 | Liquid 中文网

在项目根目录底下创建 templates 目录并建立 hello.html文件，整个目录结构如下：

hello.html 文件代码如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ hello }}</h1>
</body>
</html>

从模板中=变量使用了双括号。

接下来需要向Django说明模板文件的路径，修改settings.py，修改 TEMPLATES 中的 DIRS 为 [os.path.join(BASE_DIR, 'templates')]，如下所示:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, "templates")],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

修改 views.py视图函数，增加一个新的对象，用于向模板提交数据：

from django.shortcuts import render


def hello(request):
    context = {}
    context['hello'] = 'Hello World!'
    return render(request, 'hello.html', context)

修改根路由文件urls.py：

from django.urls import path
import App


urlpatterns = [
    path('hello/', App.views.hello, name='hello')
]

可以看到，views.py中使用 render 来替代之前使用的 HttpResponse。render 还使用了一个字典 context 作为参数。

context 字典中元素的键值 hello 对应了模板中的变量 {{ hello }}。

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

这样就完成了使用模板来输出数据，从而实现数据与视图分离。

接下来介绍模板中常用的语法规则。

列表

templates 中的 hello.html中，可以用 . 索引下标取出对应的元素。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_list = ["青菜", "胡萝卜", "白菜"]
    return render(request, "hello.html", {"html_list": views_list})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ html_list }}</h1>
    <h1>{{ html_list.0 }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

字典

templates 中的 hello.html中，可以用 .键取出对应的值。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_dict = {"name": "番茄炒蛋"}
    return render(request, "hello.html", {"html_dict": views_dict})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ html_dict }}</h1>
    <h1>{{ html_dict.name }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

过滤器

模板语法：

{{ 变量名 | 过滤器：可选参数 }}

具体可以参考简介 – Liquid 模板语言中文文档 | Liquid 中文网

模板过滤器可以在变量被显示前修改它，过滤器使用管道字符，如下所示：

{{ name|lower }}

{{ name }} 变量被过滤器 lower 处理后，文档大写转换文本为小写。

过滤管道可以被* 套接* ，既是说，一个过滤器管道的输出又可以作为下一个管道的输入：

{{ my_list|first|upper }}

以上实例将第一个元素并将其转化为大写。

有些过滤器有参数。过滤器的参数跟随冒号之后并且总是以双引号包含。例如：

{{ bio|truncatewords:"30" }}

这个将显示变量 bio 的前30个词。

其他过滤器：

addslashes : 添加反斜杠到任何反斜杠、单引号或者双引号前面。
date : 按指定的格式字符串参数格式化 date 或者 datetime 对象，实例：
```
{{ pub_date|date:"F j, Y" }}
```
length : 返回变量的长度。

default

default 为变量提供一个默认值。

如果 views 传的变量的布尔值是 false，则使用指定的默认值。

以下值为 false：

0  0.0  False  0j  ""  []  ()  set()  {}  None

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    name = 0
    return render(request, "hello.html", {"name": name})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ name|default:"番茄炒蛋YYDS" }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

length

返回对象的长度，适用于字符串和列表。

字典返回的是键值对的数量，集合返回的是去重后的长度。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    name = "Ground control to Major Tom."
    return render(request, "hello.html", {"name": name})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ name | length }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

filesizeformat

以更易读的方式显示文件的大小（即'13 KB', '4.1 MB', '102 bytes'等）。

字典返回的是键值对的数量，集合返回的是去重后的长度。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    num=1024
    return render(request, "hello.html", {"num": num})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ num | filesizeformat }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

date

根据给定格式对一个日期变量进行格式化。

格式 Y-m-d H:i:s返回 年-月-日小时:分钟:秒 的格式时间。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    import datetime
    now = datetime.datetime.now()
    return render(request, "hello.html", {"time": now})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ time|date:"Y-m-d H:i:s" }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

truncatechars

如果字符串包含的字符总个数多于指定的字符数量，那么会被截断掉后面的部分。

截断的字符串将以 ... 结尾。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_str = "菠萝凤梨"
    return render(request, "hello.html", {"html_str": views_str})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ html_str | truncatechars:2 }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

注意：

...也占一个字符

truncatechars截取的文本后面没有省略号的问题：

是一个bug，编码为en-us时是正常的；编码为zh-hans就有问题

在Django的setting文件中:
LANGUAGE_CODE = 'zh-hans'  #使用truncatechars不添加省略号(...)

LANGUAGE_CODE = 'en-us' #使用truncatechars会正常添加省略号(...)

safe

将字符串标记为安全，不需要转义。

要保证 views.py 传过来的数据绝对安全，才能用 safe。

和后端 views.py 的 mark_safe 效果相同。

Django 会自动对 views.py 传到HTML文件中的标签语法进行转义，令其语义失效。加 safe 过滤器是告诉 Django 该数据是安全的，不必对其进行转义，可以让该数据语义生效。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_str = "<a href='https://www.baidu.com/'>点击跳转</a>"
    return render(request, "hello.html", {"html_str": views_str})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>{{ html_str | safe }}</h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

if/else 标签

基本语法格式如下：

{% if condition %}
     ... display
{% endif %}

或者：

{% if condition1 %}
   ... display 1
{% elif condition2 %}
   ... display 2
{% else %}
   ... display 3
{% endif %}

根据条件判断是否输出。if/else 支持嵌套。

{% if %} 标签接受 and ， or 或者 not 关键字来对多个变量做判断，或者对变量取反（ not )，例如：

{% if athlete_list and coach_list %}
     athletes 和 coaches 变量都是可用的。
{% endif %}

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_num = 88
    return render(request, "hello.html", {"num": views_num})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>
        {%if num > 90 and num <= 100 %}
        优秀
        {% elif num > 60 and num <= 90 %}
        合格
        {% else %}
        不及格
        {% endif %}
    </h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

for 标签

{% 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>

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_list = ["青菜", "胡萝卜", "西蓝花", "白菜"]
    return render(request, "hello.html", {"html_list": views_list})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>
        {% for i in html_list %}
        {{ i }}
        {% endfor %}
    </h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

给标签增加一个 reversed 使得该列表被反向迭代：

{% for athlete in athlete_list reversed %}
...
{% endfor %}

{% for i in html_list  reversed%}
{{ i }}
{% endfor %}

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

遍历字典: 可以直接用字典 .items 方法，用变量的解包分别获取键和值。

views.py 文件代码：

from django.shortcuts import render


def hello(request):
    views_dict = {"name": "Amy", "age": 18}
    return render(request, "hello.html", {"html_dict": views_dict})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>
        {% for i,j in html_dict.items %}
        {{ i }}---{{ j }}
        {% endfor %}
    </h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

在 {% for %} 标签里可以通过 {{forloop}} 变量获取循环序号。

forloop.counter: 顺序获取循环序号，从 1 开始计算（1 2 3 4 5）
forloop.counter0: 顺序获取循环序号，从 0 开始计算（0 1 2 3 4）
forloop.revcounter: 倒序获取循环序号，结尾序号为 1（5 4 3 2 1）
forloop.revcounter0: 倒序获取循环序号，结尾序号为 0 （4 3 2 1 0）
forloop.first（一般配合if标签使用）: 第一条数据返回 True，其他数据返回 False（True False False False False）
forloop.last（一般配合if标签使用）: 最后一条数据返回 True，其他数据返回 False（False False False False True）

{% empty %}

可选的 {% empty %} 从句：在循环为空的时候执行（即 in 后面的参数布尔值为 False ）。

views.py 文件代码：

from django.shortcuts import render

def hello(request):
    views_list = []
    return render(request, "hello.html", {"listvar": views_list})

hello.html 文件代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>
        {% for i in listvar %}
            {{ forloop.counter0 }}
        {% empty %}
           循环为空
        {% endfor %}
    </h1>
</body>
</html>

再次访问 http://127.0.0.1:8000/hello，可以看到页面：

可以嵌套使用 {% for %} 标签：

{% for athlete in athlete_list %}
    <h1>{{ athlete.name }}</h1>
    <ul>
    {% for sport in athlete.sports_played %}
        <li>{{ sport }}</li>
    {% endfor %}
    </ul>
{% endfor %}

ifequal/ifnotequal 标签

{% ifequal %} 标签比较两个值，当他们相等时，显示在 {% ifequal %} 和 {% endifequal %} 之中所有的值。

下面的例子比较两个模板变量 user 和 currentuser :

{% ifequal user currentuser %}
    <h1>Welcome!</h1>
{% endifequal %}

和 {% if %} 类似， {% ifequal %} 支持可选的 {% else%} 标签：8

{% ifequal section 'sitenews' %}
    <h1>Site News</h1>
{% else %}
    <h1>No News Here</h1>
{% endifequal %}

注释标签

Django 注释使用 {# #}。

{# 这是一个注释 #}

include 标签

{% include %} 标签允许在模板中包含其它的模板的内容。

下面这个例子都包含了 nav.html 模板：

{% include "nav.html" %}

csrf_token

csrf_token 用于form表单中，作用是跨站请求伪造保护。

如果不用 {% csrf_token %} 标签，在用 form 表单时，要再次跳转页面会报 403 权限错误。

用了{% csrf_token %} 标签，在 form 表单提交数据时，才会成功。

解析：

首先，向服务器发送请求，获取登录页面，此时中间件 csrf 会自动生成一个隐藏input标签，该标签里的 value 属性的值是一个随机的字符串，用户获取到登录页面的同时也获取到了这个隐藏的input标签。

然后，等用户需要用到form表单提交数据的时候，会携带这个 input 标签一起提交给中间件 csrf，原因是 form 表单提交数据时，会包括所有的 input 标签，中间件 csrf 接收到数据时，会判断，这个随机字符串是不是第一次它发给用户的那个，如果是，则数据提交成功，如果不是，则返回403权限错误。