Django 基础知识详细图文教程 10-Django 模板引擎 3

作者:月月芽日期:2026/9/25

来源引用网络知识与某站曹老师视频相互结合学习记录,仅供参考!

Django 模板引擎

Django 作为 Web 框架,需要一种很便利的方法动态地生成 HTML 网页,因此有了模板这个概念;模板包含所需 HTML 的部分代码以及一些特殊语法,特殊语法用于描述如何将视图传递的数据动态插入 HTML 网页中;简单来说,模板引擎的具体思路就是通过一个通用模板加动态数据等于生成一个网页。

Django 可以配置一个或者多个模板引擎(甚至是 0 个,例如前后端分离(就不需要模板了,只需要提供 API 接口,返回 JSON 数据),Django 只提供 API 接口,无须使用模板引擎),模板引擎有Django 模板语言(Django Template Language,DTL)和 Jinja3;Django 模板语言是Django 内置的功能之一,Jinja3 是当前 Python 流行的模板语,Jinja3 是对Django 内置模板的一个扩展,一些高级开发扩展一般建议使用Jinja。

Django 内置模板引擎

Django 内置的模板引擎包含模板上下文(亦可称为模板变量)、标签和过滤器,各个功能说明如下:

  • 模板上下文是以变量的形式写入模板文件里面,变量值由视图函数或视图类传递所得;
  • 标签是对模板上下文进行控制输出,比如模板上下文的判断和循环控制等;
  • 公共模板抽取,模板继承隶属于标签,它是将每个模板文件重复的代码抽取出来并写在一个共用的模板文件中,其他模板文件通过继承共用模板文件来实现完整的网页输出;
  • 过滤器是对模板上下文进行操作处理;例如说模板上下文的内容截取、替换或者格式转化等。
模板上下文

模板上下文是模板中基本的组成单位,上下文的数据由视图函数或视图类传递;它是以两个大/花括号,里面加上变量内容来{{ variable }}表示,其中 variable 是上下文的名称,它支持 Python 所有的数据类型 ,如字典、列表、元组、字符串、整型或实例化对象等;上下文的数据格式不同,在模板里的使用方式也有所差异;

自定义标签

标签是对模板上下文进行控制输出,它是以{% tag %}表示的,其中 tag是标签的名称,Django内置了许多模板标签;例如:{% if %}(判断标签)、{% for %}(循环标签)或{% url %}(路由标签)等;

模板继承

Django模板继承是一个强大的工具,可以将通用页面元素(比如说“页眉、页脚、侧边栏”等)分离出来,并在多个页面之间共享它们;就是说可以做一个基础模板,其他页面的模板可以继承这个基础模板来实现一个通用功能的一些封装;模板继承和 Python 语言中类的继承含义是一样的,在 Django 中模板只是一个文本文件(例如:HTML),只需要一个文件(HTML)放在 templates 模板目录文件路径下即可;模板继承是 Django 模板语言中最强大的部分,模板继承可以构建基本的“骨架”模板,将通用的功能或者属性写在基础模板中,也叫基类模板或者父模板;子模板可以继承父类模板,子模板继承后将自动拥有父类中的属性和方法,还可以在子模板中对父模板进行重写,即重写父模板中方法或者属性,从而实现子模板的定制;模板继承大大提高了代码的可重用性,减轻开发人员的工作量;

在模板继承中最常用了标签就是 {% block %} 与 {% extends %} 标签,其中 {% block% } 标签与 {% endblock %} 标签成对出现;

自定义过滤器

Django过滤器是一种用于在Django模板中处理数据的一种技术;过滤器的作用是可以对模板中的变量进行加工、过滤或格式化,返回一个新的值供模板使用;过滤器作用是在变量输出时,对输出的变量值做进一步的处理,可以使用过滤器来更改变量的输出显示;过滤器跟模板标签一样,也是在模板中对函数进行调用对输出的日期进行格式化处理,或者转换大小写字母等,这些都是有对应的过滤器去处理它们;

过滤器的语法格式():

{{ 变量 | 过滤器1:参数值1 | 过滤器2:参数值2 ... }}

1{{ 变量 过滤器1:参数值1 | 过滤器2:参数值2 ... }}
2
3● 首先是“模板变量”
4● 其次是一个竖线“|(管道符)”
5● 后面再跟“过滤器的名称”
6● 然后冒号“:”后面跟参数
7里面可以跟多个管道过滤器,可以处理多次。

Jinja 模板引擎

Jinja是Python里面被广泛应用的模板引擎,目前最新版本3.1.6 版本,所以有部分人称为Jinja3,但是Jinja2 版本使用时间长,且是长期维护的,也被很多人叫“Jinja2”,至于为什么不叫“Jinja3”版本呢?是因为目前安装时使用的还是“Jinja2”的方式,安装的也是最新 v3.1.6 版本,但是Jinja 官方社区并没有宣称“Jinja3”版本,到目前为止仍是声称为“Jinja2 Version 3.1.6”版本,虽然说挺奇怪的,不过并不妨碍学习使用;它的设计思想来源于Django的模板引擎,并扩展了其语法和一系列强大的功能,所以它是Django模板引擎的扩展,因此功能更加的丰富、强大,如果是需要一些强大功能的时候,建议可以使用Jinja3 模板引擎,一般情况下在开发过程中使用内置的Django模板引擎就够了;

Jinja3 模板引擎其中最显著的是增加了沙箱执行功能和可选的自动转义功能,这对大多数应用的安全性来说是非常重要,如果是安全性要求很高的项目,可以使用Jinja3 模板引擎;此外,它还具备以下特性:

  • 沙箱执行模式,模板的每个部分都在引擎的监督之下执行,模板将会被明确地标记在白名单或黑名单内,这样对于那些不信任的模板也可以执行;
  • 安全性,强大的自动HTML转义系统,可以有效地阻止跨站脚本攻击;
  • 模板继承机制,此机制可以使得所有模板具有相似一致的布局,也方便开发人员对模板进行修改和管理。;
  • 高效的执行效率,Jinja3 模板引擎的执行效率会高一些,Jinja3引擎在模板第一次加载时就把源码转换成Python字节码,加快模板执行时间;
  • 调试系统融合了标准的Python的TrackBack功能,使得模板编译和运行期间的错误能及时被发现和调试;
  • 语法配置,可以重新配置Jinja3,使得它更好地适应开发(LaTeX或JavaScript 的输出);

官方文档手册,此手册指导设计人员更好地使用Jinja3引擎的各种方法; Django支持 Jinja3模板引擎的使用,由于Jinja3的设计思想来源于Django 的模板引擎,因此Jinja3的使用方法与 Django 的模板语法有相似之处。

GitHub 开源主页:GitHub - pallets/jinja: A very fast and expressive template engine. · GitHub

官方文档:https://jinja.palletsprojects.com/en/stable/

安装和配置
安装

烦请自行选择安装方式;

pip命令安装;

pip install Jinja2 -i https://pypi.tuna.tsinghua.edu.cn/simple

Python 解释器安装;

  1. 打开PyCharm 工具,鼠标光标滑动到菜单栏“文件(F)”选项,在文件下拉选择菜单中选中“设置(T)...”选项后单击打开设置对话框;
  2. 然后选择项目→Python 解释器→鼠标单击“➕”安装按钮,打开可用软件包对话框;
  3. 搜索框输入需要安装的第三方库(例如:Jinja);
  4. 选中“Jinja2”选项,自行选择是否指定安装版本,单击“安装软件包(I)”开始安装;

安装成功后自行查看;

Jinja3安装成功后,接着在 Django里配置Jinja3模板,由于 Django的内置功能是使用 Django的模板引擎,如果将整个项目都改为Jinja3模板引擎,就会导致内置功能无法正常使用,在这种情况下,既要保证内置功能能够正常使用,又要使用Jinja3模板引擎,只能将两个模板引擎共存在同一个项目里;

配置

在“djangoProject”应用下“settings.py”文件中有个“TEMPLATES”配置,可以配置多个TEMPLATES,它是一个数组、元组,所以说可以配置多个;里面默认会有一个“DjangoTemplates”,可自定义配置其他项;例如:配置一个Jinja 的 Templates;

36、在“djangoProject”项目“helloWorld”应用下新建一个名称为“Jinja3 ”的 Python 文件,用来定义环境参数;在其他地方新建也行,主要是一个配置,如果说一个项目里面只有一个子项目时,可直接在子项目中新建就行了;方式方法比较多,烦请自行选择;在“helloWorld”应用下“Jinja3.py”文件中输入以下内容(固定写法,自行设置);

1from django.contrib.staticfiles.storage import staticfiles_storage
2from django.urls import reverse
3from jinja2 import Environment
4
5
6def environment(**options):
7    env = Environment(**options)
8    env.globals.update(
9        {
10            # 读取项目类的静态资源配置
11            'static': staticfiles_storage.url,
12            # url反转
13            'url': reverse
14        }
15    )
16    # 返回一个env = Environment(**options)对象
17    return env

37、修改“djangoProject”应用下“settings.py”文件中“TEMPLATES”配置项,添加配置一个Jinja 的 templates(固定配置内容,自行设置);

  • 'BACKEND': 'django.template.backends.jinja2.Jinja2'--固定写法,不用更改;
  • 'DIRS': [BASE_DIR / 'templates']--指定模板路径,自行配置一个或多个;
  • 'APP_DIRS': True--表示在子项目下找不到的话就去找父项目;一般情况下都是配置为True;
  • 'OPTIONS': {'environment': 'helloWorld.Jinja3.environment'}--一些环境的配置,自行设置;
1"""
2Django settings for djangoProject project.
3
4Generated by 'django-admin startproject' using Django 5.0.6.
5
6For more information on this file, see
7https://docs.djangoproject.com/en/5.0/topics/settings/
8
9For the full list of settings and their values, see
10https://docs.djangoproject.com/en/5.0/ref/settings/
11"""
12
13from pathlib import Path
14
15# Build paths inside the project like this: BASE_DIR / 'subdir'.
16BASE_DIR = Path(__file__).resolve().parent.parent
17
18
19# Quick-start development settings - unsuitable for production
20# See https://docs.djangoproject.com/en/5.0/howto/deployment/checklist/
21
22# SECURITY WARNING: keep the secret key used in production secret!
23SECRET_KEY = 'django-insecure-i01#=6cjknb()(5@p19olv+c2$tf7ez86)r%g!b&5(2&pdkfd0'
24
25# SECURITY WARNING: don't run with debug turned on in production!
26DEBUG = True
27
28ALLOWED_HOSTS = []
29
30
31# Application definition
32
33INSTALLED_APPS = [
34    'django.contrib.admin',
35    'django.contrib.auth',
36    'django.contrib.contenttypes',
37    'django.contrib.sessions',
38    'django.contrib.messages',
39    'django.contrib.staticfiles',
40    "helloWorld.apps.HelloworldConfig",
41    "user.apps.UserConfig",
42    "order.apps.OrderConfig"
43]
44
45MIDDLEWARE = [
46    'django.middleware.security.SecurityMiddleware',
47    'django.contrib.sessions.middleware.SessionMiddleware',
48    'django.middleware.common.CommonMiddleware',
49    'django.middleware.csrf.CsrfViewMiddleware',
50    'django.contrib.auth.middleware.AuthenticationMiddleware',
51    'django.contrib.messages.middleware.MessageMiddleware',
52    'django.middleware.clickjacking.XFrameOptionsMiddleware',
53    'helloWorld.mymid.md1.Md1'
54]
55
56ROOT_URLCONF = 'djangoProject.urls'
57
58TEMPLATES = [
59    {
60        'BACKEND': 'django.template.backends.jinja2.Jinja2',
61        'DIRS': [BASE_DIR / 'templates']
62        ,
63        'APP_DIRS': True,
64        'OPTIONS': {
65            'environment': 'helloWorld.Jinja3.environment'
66        },
67    },
68    {
69        'BACKEND': 'django.template.backends.django.DjangoTemplates',
70        'DIRS': [BASE_DIR / 'helloWorld/templates', BASE_DIR / 'templates']
71        ,
72        'APP_DIRS': True,
73        'OPTIONS': {
74            'context_processors': [
75                'django.template.context_processors.debug',
76                'django.template.context_processors.request',
77                'django.contrib.auth.context_processors.auth',
78                'django.contrib.messages.context_processors.messages',
79            ],
80        },
81    },
82]
83
84WSGI_APPLICATION = 'djangoProject.wsgi.application'
85
86
87# Database
88# https://docs.djangoproject.com/en/5.0/ref/settings/#databases
89
90DATABASES = {
91    'default': {
92        'ENGINE': 'django.db.backends.mysql',
93        'NAME': 'db_django6',
94        'USER': 'root',
95        'PASSWORD': '123',
96        'HOST': '192.168.88.145',
97        'PORT': '3306'
98    }
99}
100
101
102# Password validation
103# https://docs.djangoproject.com/en/5.0/ref/settings/#auth-password-validators
104
105AUTH_PASSWORD_VALIDATORS = [
106    {
107        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
108    },
109    {
110        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
111    },
112    {
113        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
114    },
115    {
116        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
117    },
118]
119
120
121# Internationalization
122# https://docs.djangoproject.com/en/5.0/topics/i18n/
123
124LANGUAGE_CODE = 'en-us'
125
126TIME_ZONE = 'UTC'
127
128USE_I18N = True
129
130USE_TZ = True
131
132
133# Static files (CSS, JavaScript, Images)
134# https://docs.djangoproject.com/en/5.0/howto/static-files/
135
136STATIC_URL = 'static/'
137
138# 设置静态资源文件集合
139STATICFILES_DIRS = [BASE_DIR / "static", BASE_DIR / "helloWorld/images", BASE_DIR / "common"]
140
141# 设置媒体路由
142MEDIA_URL = 'media/'
143# 设置media目录的完整路径
144MEDIA_ROOT = BASE_DIR / 'media'
145
146# Default primary key field type
147# https://docs.djangoproject.com/en/5.0/ref/settings/#default-auto-field
148
149DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
150

配置完成之后,“JinjaTemplates”的优先级在“DjangoTemplates”之前,现在是“DjangoTemplates”和“JinjaTemplates”两个模板引擎共存的;

Django 里面还内置了一些“Auth(django.contrib.auth)、Admin(django.contrib.admin) 后台管理系统”等功能,默认使用的是Django模板引擎,如若把“DjangoTemplates”去掉之后,这些就不能用了;当然,在实际项目开发过程中是不使用这些内置功能的,所以不使用的话就是可以去掉的,一般开发会自己开发出对应的一套 admin 或 auth 系统;因为可以自行开发,然后单独使用Jinja 模板引擎,反正就是掌握了之后,怎么使用都行。

测试验证

38、此时重新运行项目,浏览器输入“http://127.0.0.1:8000/index/”测试,可以发现打开的是项目“templates”目录文件下的“index.html”文件,因为优先查找的是父项目而不是“helloWorld”子项目;

39、修改项目“templates”目录文件下的“index.html”文件内容;

1<!DOCTYPE html>
2<html lang="en">
3<head>
4    <meta charset="UTF-8">
5    <title>Title Is Django or Jinja Hello World</title>
6</head>
7<body>
8    字典类型(Django模板引擎支持的' msg2.Jack ',Jinja模板引擎也支持):{{ msg2.Jack }}<br>
9    字典类型(Django模板引擎不支持的' msg2['King'] ',Jinja模板引擎还支持):{{ msg2['King'] }}<br>
10    <h1>定义一个h1大标题</h1>
11    <p>定义一个段落</p>
12    <a href="https://www.runoob.com/django/django-tutorial.html">这是一个"Django 教程"链接</a><br>
13    <a href="https://jinja.palletsprojects.com/en/stable/">这是一个"Jinja 官方文档"链接</a><br>
14<h2>h2标题 Django Hello World</h2>
15    <p>又是一个段落;然后下面是一张图片。</p>
16    <img src="https://www.runoob.com/wp-content/uploads/2015/01/admin1.png" width="280" height="200"  alt=""/>
17    <br>
18<a href="https://www.runoob.com/html/html-tutorial.html">这是一个"HTML 教程"链接</a>
19</body>
20</html>

40、浏览器输入“http://127.0.0.1:8000/index/”打开 index(重新打开或者刷新)页面测试查看,经测试验证,已经成功应用Jinja模板引擎;

模板语法

尽管Jinja3的设计思想来源于Django 的模板引擎,但在功能和使用细节上是有区别的,Jinja3比Django的模板引擎更加完善,在 Django 的基础上多做了一些扩展;而且Jinja3的模板语法在使用上与 Django的模板引擎存在一定的差异;具体区别可参考官方文档(Jinja3模板帮助手册):Template Designer Documentation — Jinja Documentation (3.1.x);因此仅简单讲述Jinja3与 Django模板语言的语法使用区别;

41、复制“helloWorld”子项目“templates”目录文件下的“index.html”文件,复制替换掉项目“templates”目录文件下的“index.html”文件,需要注意是替换,既是两个“index.html”文件内容完全相同;

42、浏览器输入“http://127.0.0.1:8000/index/”打开 index(重新打开或者刷新)页面测试查看;

可以看到提示报错信息,暂时先修改这三个问题;

  1. 首先是 url,使用方法不对,是有区别,先注释掉 url 信息或者更改为 Jinja3 支持的方式;
  2. 其次是内置过滤器中的日期 date 数据信息指定格式化报错,暂时先删除整段内置过滤器内容;
  3. 然后是“forloop未定义”,因为 Jinja 里面的 for 标签用法是不一样的,把 for 标签里面的三个“forloop”替换为“loop”;

43、修改项目“templates”目录文件下的“index.html”文件内容,修改为 Jinja 支持的语法格式,输入以下内容;

1<!DOCTYPE html>
2<html lang="en">
3  <head>
4    <meta charset="UTF-8">
5    <title>Title Is Django Hello World index2</title>
6  </head>
7  <body>
8    模板取值--字符串:{{ content_msg }}<br>
9    模板取值--字典类型:{{ msg2.Jack }},{{ msg2.Queen }},{{ msg2.King }},{{ msg2.King2 }}<br>
10    模板取值--对象:{{ msg3.name }},{{ msg3.age }}<br>
11    模板取值--列表:{{ msg4.0 }},{{ msg4.1 }},{{ msg4.2 }},{{ msg4.3 }},{{ msg4.4 }},{{ msg4.5 }},{{ msg4.6 }},{{ msg4.61 }}<br>
12    模板取值--元组:{{ msg5.0 }},{{ msg5.6 }},{{ msg5.5 }},{{ msg5.4 }},{{ msg5.3 }},{{ msg5.2 }},{{ msg5.1 }},{{ msg5.11 }}<br>
13    <h3>模板标签</h3>
14    <p>遍历for标签:</p>
15    {% for item in msg4 %}
16        <p>这个是第{{ loop.counter }}次遍历</p>
17        {% if loop.first %}
18            <p>这个是第一项:{{ item }}</p>
19        {% elif loop.last %}
20            <p>这个是最后一项:{{ item }}</p>
21        {% endif %}
22    {% endfor %}
23    <p>判断标签if</p>
24    {% if content_msg == '模板变量' %}
25        <p>模板变量</p>
26    {% elif content_msg == '传递字符串类型--模板引擎' %}
27        <p>传递字符串类型--模板引擎</p>
28    {% else %}
29        <p>其他</p>
30    {% endif %}
31    <p>url标签</p>
32{#    <a href="{% url 'index' %}" target="_blank">请求index地址</a>#}
33    <a href="{{ url('index') }}" target="_blank">请求index地址</a>
34    <p>with标签</p>
35    {% with info=content_msg %}
36        {{ info }}
37    {% endwith %}
38    
39    <h1>定义一个h1大标题“index2”</h1>
40    <p>定义一个段落“index2”</p>
41    <h2>h2标题“index2” Django Hello World</h2>
42    <p>又是一个段落;“index2”然后下面是一张图片。</p>
43    <img src="https://www.runoob.com/wp-content/uploads/2015/01/admin1.png" width="304" height="228"  alt=""/>
44    <br>
45    <a href="https://www.runoob.com/html/html-tutorial.html">这是一个"HTML 教程 index2"链接</a>
46  </body>
47</html>

44、浏览器输入“http://127.0.0.1:8000/index/”测试验证,又发现了不一样的缺陷,假如说对象的属性不存在时,某个属性不存在时 Django 的默认处理方式是空字符串,但不是 Jinja 的处理方式,在 Jinja 里面是会报错显示的;因为在 Jinja 里面是没有“counter”属性的,在 Jinja 里面是叫做“length”属性;

在for循环块内部,您可以访问一些特殊变量:Template Designer Documentation — Jinja Documentation (3.1.x)

变量(Variable)描述(Description)说明
loop.index循环的当前迭代(索引从 1 开始)。
loop.index0循环的当前迭代(索引从 0 开始)。
loop.revindex循环结束后的迭代次数(索引从 1 开始)。
loop.revindex0循环结束后的迭代次数(索引从 0 开始)。
loop.first如果是第一次迭代,就为True。
loop.last如果是最后一次迭代,则为True。
loop.length序列中的项目数,即循环总次数。
loop.cycle循环:一个在序列列表之间循环的辅助函数。辅助函数,用于在序列列表之间循环。 在for循环中,可以使用特殊的loop.cycle助手在每次循环中在字符串/变量列表之间循环。 自Jinja 2.1以来,存在一个额外的循环辅助器,允许循环无约束循环。有关更多信息,请查看全局函数列表。
loop.depth环路深度:指示渲染当前在递归循环中的深度,从级别1开始。
loop.depth0指示渲染当前在递归循环中的深度,从级别0开始。
loop.previtem循环.审查:上一次迭代中的对象;循环前一次迭代中的项目,在第一次迭代中未定义。
loop.nextitem下一次迭代中的对象;循环后续迭代中的项目。在上次迭代中未定义。
loop.changed(*val)循环已更改(*val):如果之前用不同的值调用(或根本不调用),则为True。 若上传迭代的值与当前迭代的值不同,则返回True。

45、继续修改项目“templates”目录文件下的“index.html”文件内容,修改为 Jinja 支持的语法格式,更改“counter”为“length”属性;

1<!DOCTYPE html>
2<html lang="en">
3  <head>
4    <meta charset="UTF-8">
5    <title>Title Is Django Hello World index2</title>
6  </head>
7  <body>
8    模板取值--字符串:{{ content_msg }}<br>
9    模板取值--字典类型:{{ msg2.Jack }},{{ msg2.Queen }},{{ msg2.King }}<br>
10    模板取值--对象:{{ msg3.name }},{{ msg3.age }}<br>
11    模板取值--列表:{{ msg4.0 }},{{ msg4.1 }},{{ msg4.2 }},{{ msg4.3 }},{{ msg4.4 }},{{ msg4.5 }},{{ msg4.6 }},{{ msg4.61 }}<br>
12    模板取值--元组:{{ msg5.0 }},{{ msg5.6 }},{{ msg5.5 }},{{ msg5.4 }},{{ msg5.3 }},{{ msg5.2 }},{{ msg5.1 }},{{ msg5.11 }}<br>
13    <h3>模板标签</h3>
14    <p>遍历for标签:</p>
15    {% for item in msg4 %}
16        <p>这个是第{{ loop.length }}次遍历</p>
17        {% if loop.first %}
18            <p>这个是第一项:{{ item }}</p>
19        {% elif loop.last %}
20            <p>这个是最后一项:{{ item }}</p>
21        {% endif %}
22    {% endfor %}
23    <p>判断标签if</p>
24    {% if content_msg == '模板变量' %}
25        <p>模板变量</p>
26    {% elif content_msg == '传递字符串类型--模板引擎' %}
27        <p>传递字符串类型--模板引擎</p>
28    {% else %}
29        <p>其他</p>
30    {% endif %}
31    <p>url标签</p>
32{#    <a href="{% url 'index' %}" target="_blank">请求index地址</a>#}
33    <a href="{{ url('index') }}" target="_blank">请求index地址</a>
34    <p>with标签</p>
35    {% with info=content_msg %}
36        {{ info }}
37    {% endwith %}
38    
39    <h1>定义一个h1大标题“index2”</h1>
40    <p>定义一个段落“index2”</p>
41    <h2>h2标题“index2” Django Hello World</h2>
42    <p>又是一个段落;“index2”然后下面是一张图片。</p>
43    <img src="https://www.runoob.com/wp-content/uploads/2015/01/admin1.png" width="304" height="228"  alt=""/>
44    <br>
45    <a href="https://www.runoob.com/html/html-tutorial.html">这是一个"HTML 教程 index2"链接</a>
46  </body>
47</html>

46、浏览器输入“http://127.0.0.1:8000/index/”测试验证,可以看到已解决 for 标签中的“no such element”报错信息;

47、把“helloWorld”子项目“templates”目录文件下的“base.html”和“course.html”文件,复制一份到项目的“templates”目录文件路径下;

48、浏览器输入“http://127.0.0.1:8000/toCourse/”测试验证,可以看到还是会有报错信息,虽然Django 和 Jinja3在模板继承用法方面基本是一样的,但是在static函数用法上是有区别的,和 url 函数用法一样,也是不一样的;

49、修改项目“templates”目录文件路径下的“base.html”文件内容;

1<!DOCTYPE html>
2<html lang="en">
3<head>
4    <meta charset="UTF-8">
5    <title>
6        {% block title %}
7            Python 学习
8        {% endblock %}
9    </title>
10</head>
11{#先注释load static#}
12{#{% load static %}#}
13<body>
14<div id="head">
15{#    <img src="{% static 'Djangologo.png' %}">#}
16{#    直接修改#}
17    <img src="{{ static('Djangologo.png') }}">
18</div>
19<div id="content">
20    {% block content %}
21    这是 content 内容,它是一个子页面,基本都需要更改的,烦请自定义;
22    {% endblock %}
23</div>
24<div id="footer">
25    页脚footer约定好不需要修改,让所有的子类模板都能继承。
26</div>
27</body>
28</html>

50、浏览器输入“http://127.0.0.1:8000/toCourse/”测试验证,能够正确打开展示相关页面;

总结:
  • url函数用法不一样;
  • 在遍历for标签上,属性不一样,Jinja3内置的对象是loop;
  • 如是是对象的属性不存在,或者是列表、元组的下标以及字典类型的元素,没有取到值时,Jinja3 都会返回具体的报错信息:no such element;
  • 相比较Django,Jinja3在static函数用法上也有区别,和 url 函数用法一样,也是不一样的;Django 和 Jinja3在模板继承方式是一样的;

主要就是这些区别,这些都需要掌握,要会看,其他某些情况可以查看具体文档。

过滤器

Jinja3的过滤器用法与 Django内置过滤器的使用方法基本上是一样的,有相似之处,也是由管道符号“|”连接模板上下文和过滤器,但是两者的过滤器名称是不同的,内置的过滤器种类是不一样的,而且过滤器的参数设置方式也不同;

具体使用可以参考下Jinja3官方文档:Template Designer Documentation — Jinja Documentation (3.1.x)

官方文档专门罗列出所有的 Jinja 过滤器,其中 Jinja3 常用过滤器如下所示;

过滤器说明描述
abs设置数值的绝对值。
default设置默认值。
escape转义字符,转成HTML的语法。
first获取上下文的第一个元素。
last获取上下文的最后一个元素。
length获取上下文的长度。
join功能与Python的join语法一致。
safe将上下文转义处理。
int将上下文转换为int类型。
float将上下文转换为float类型。
lower将字符串转换为小写。
upper将字符串转换为大写。
replace字符串的替换。
truncate字符串的截断。
striptags删除字符串中所有的HTML标签。
trim截取字符串前面和后面的空白字符。
string将上下文转换成字符串。
wordcount计算长字符串的单词个数。

51、修改项目“templates”目录文件路径下的“index.html”文件内容,添加 Jinja 过滤器实例;

1<!DOCTYPE html>
2<html lang="en">
3  <head>
4    <meta charset="UTF-8">
5    <title>Title Is Django Hello World index2</title>
6  </head>
7  <body>
8    模板取值--字符串:{{ content_msg }}<br>
9    模板取值--字典类型:{{ msg2.Jack }},{{ msg2.Queen }},{{ msg2.King }}<br>
10    模板取值--对象:{{ msg3.name }},{{ msg3.age }}<br>
11    模板取值--列表:{{ msg4.0 }},{{ msg4.1 }},{{ msg4.2 }},{{ msg4.3 }},{{ msg4.4 }},{{ msg4.5 }},{{ msg4.6 }},{{ msg4.61 }}<br>
12    模板取值--元组:{{ msg5.0 }},{{ msg5.6 }},{{ msg5.5 }},{{ msg5.4 }},{{ msg5.3 }},{{ msg5.2 }},{{ msg5.1 }},{{ msg5.11 }}<br>
13    <h3>模板标签</h3>
14    <p>遍历for标签:</p>
15    {% for item in msg4 %}
16        <p>这个是第{{ loop.length }}次遍历</p>
17        {% if loop.first %}
18            <p>这个是第一项:{{ item }}</p>
19        {% elif loop.last %}
20            <p>这个是最后一项:{{ item }}</p>
21        {% endif %}
22    {% endfor %}
23    <p>判断标签if</p>
24    {% if content_msg == '模板变量' %}
25        <p>模板变量</p>
26    {% elif content_msg == '传递字符串类型--模板引擎' %}
27        <p>传递字符串类型--模板引擎</p>
28    {% else %}
29        <p>其他</p>
30    {% endif %}
31    <p>url标签</p>
32{#    <a href="{% url 'index' %}" target="_blank">请求index地址</a>#}
33    <a href="{{ url('index') }}" target="_blank">请求index地址</a>
34    <p>with标签</p>
35    {% with info=content_msg %}
36        {{ info }}
37    {% endwith %}
38    
39    <p>Jinja过滤器</p>
40    first(获取第一个元素):{{ content_msg | first }}<br>
41    last(获取最后一个元素):{{ content_msg | last }}<br>
42    length(获取总长度):{{ content_msg | length }}<br>
43    upper(将字符串转换为大写):{{ content_msg | upper }}<br>
44    
45    <h1>定义一个h1大标题“index2”</h1>
46    <p>定义一个段落“index2”</p>
47    <h2>h2标题“index2” Django Hello World</h2>
48    <p>又是一个段落;“index2”然后下面是一张图片。</p>
49    <img src="https://www.runoob.com/wp-content/uploads/2015/01/admin1.png" width="304" height="228"  alt=""/>
50    <br>
51    <a href="https://www.runoob.com/html/html-tutorial.html">这是一个"HTML 教程 index2"链接</a>
52  </body>
53</html>

52、浏览器输入“http://127.0.0.1:8000/index/”测试验证 Jinja 过滤器,均能够成功获取到对应的值。

未完待续......


参考文档


《Django 基础知识详细图文教程 10-Django 模板引擎 3》 是转载文章,点击查看原文。


相关推荐


Grill Me:开工前先被拷问一遍
是2的10次方啊2026/9/17

AI 能写代码了,但老问题还在:Agent 写完了,不是你想要的。 症结往往是 理解偏差(misalignment)——你脑子里还是模糊想法,Agent 已经按自己的理解开工了。 Matt Pocock 的 /grill-me 专门治这个:在写代码、写规格之前,用结构化问答把想法拷问到能拍板。下面讲它是什么、怎么用、和 OpenSpec 怎么错开——Demo 用 Java 后端场景。 一、Grill Me 是什么? Grill Me 不是独立仓库,而是 mattpocock/skills 合集


Android 架构演进:从生命周期事件到结构化任务
潜龙勿用之化骨龙2026/9/9

Android 生命周期,是每一个 Android 开发者都绕不开的痛。 早期我们习惯在: onStart() onStop() onResume() onPause() 里面处理各种业务。 后来有了 LifecycleObserver,再到 Kotlin 协程、Flow 成为现代 Android 异步编程的重要组成部分。 如果只是从 API 的变化来看,很容易得到: Lifecycle 回调 ↓ LifecycleObserver ↓ Coroutine /


举手之劳 -- 肘子的 Swift 周报 #151
东坡肘子2026/9/1

举手之劳 上个周末,我在北京参加了由苹果举办的 App 孵化器活动,本次的主题主要围绕 AI 时代的应用开发、运营和商业模式展开。与会者大多是 IT 公司的管理者和应用开发者,整个活动期间,大家对 AI 的热情都很高,也纷纷讨论各自对于 AI 的理解和应用技巧,我从中收获不少。 会议结束后,我和一位从事传统行业的朋友吃饭。他对 AI 基本一窍不通。作为一个新兴概念,他也想了解,但一直没有切实感受到 AI 究竟能给他的企业带来什么。就餐过程中,他接到一个电话,一个客户要求立刻调整方案。当时正值周末


NativePHP v4 让 Blade 构建原生 iOS 与 Android 界面
BingoGo2026/8/24

NativePHP v4 让 Blade 构建原生 iOS 与 Android 界面 NativePHP 现在可以将 Blade 组件渲染为 iOS 上真正的 SwiftUI 视图和 Android 上的 Jetpack Compose 视图,整个过程无需 WebView 或 HTML。NativePHP 将这项技术称为 SuperNative。Simon Hamp 与 Shane Rosenthal 于 7 月 30 日在二人于波士顿主办的 The Vibes 活动上发布了 SuperNati


Apple Intelligence 已通过审核,即将在中国提供服务 -- 肘子的 Swift 周报 #148
东坡肘子2026/8/11

Apple Intelligence 已通过审核,即将在中国提供服务 在 WWDC 26 上,苹果公布了新的 Apple Intelligence 架构,不仅在云端引入 Gemini,第三代 Apple Foundation Models 也确认由苹果与 Google 合作构建。这一度让我以为,Apple Intelligence 进入中国市场的难度反而进一步增加了。 但事情的发展比预想中更快。7 月,Apple Intelligence 已经出现在中国国家互联网信息办公室(CAC)公布的最新一


最小二乘法计算触摸事件速度
别怪我很水2026/8/1

最小二乘法计算触摸事件速度 引言:为什么需要计算触摸速度?在触控设备(如手机、平板、触摸屏)上,我们经常需要根据用户的触摸滑动速度来调整交互行为。例如,在滚动列表时,快速滑动应该让列表继续惯性滚动一段距离,而慢速滑动则应该立即停止。这些功能的核心在于准确计算触摸事件的速度。然而,由于触摸采样率的限制和手指抖动的噪声干扰,直接使用相邻两点的位移除以时间间隔会得到不稳定的速度值。最小二乘法通过拟合多个采样点的数据,能够有效平滑噪声,估算出更准确的速度。## 基础概念:最小二乘法的数学原理最小二乘法是


QML 文字波动与视觉干扰:波浪、倒影、故障
Quz2026/7/24

目录 Demo 1 波浪跳动 演示代码 关键逻辑解析 Demo 2 倒影镜像 演示代码 关键逻辑解析 Demo 3 故障风效果 演示代码 关键逻辑解析 运行验证 扩展复用方向 工程下载


Android window属性全解析
solo_992026/7/16

Android Theme XML 属性如何影响 PhoneWindow:从 TypedArray 到 LayoutParams 的完整链路 每天写布局、配主题,但你有没有想过——android:windowIsTranslucent="true" 这行 XML 到底是怎么一路传递,最终影响了 Window 的像素格式?为什么 statusBarColor 有时候怎么设都不生效?FLAG_LAYOUT_IN_SCREEN 到底是干什么的?本文将带你深入 Android Framework 源码


GitHub 热榜项目 - 周榜(2026-07-04)
CoderJia_2026/7/8

GitHub 热榜项目 - 周榜(2026-07-04) 生成于:2026-07-04 共发现热门项目: 21 个 Token赞助:siliconflow 前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到网站。 本期热点趋势总结 本期 GitHub 热榜明显聚焦 AI Agent 工程化:多智能体协作、MCP / 知识图谱记忆、代码库索引与任务编排成为核心热点,代码生成、网页克隆、视频编辑、招聘评估等场景快速落地;


【从零开始大模型开发与微调:基于PyTorch与ChatGLM】(一学就会的深度学习基础算法详解)
承渊政道2026/6/30

🔥承渊政道:个人主页 ❄️个人专栏: 《C语言基础语法知识》 《数据结构与算法》 《C++知识内容》 《Linux系统知识》 《算法刷题指南》 《测评文章活动推广》 《大模型语言路线学习》 《MySQL数据库学习》 ✨逆境不吐心中苦,顺境不忘来时路!✨ 🎬 博主简介: 神经网络看起来由大量矩阵、激活函数和参数组成,但训练过程可以浓缩成四句话:先用当前参数完成一次预测;再用损失函数衡量预测有多差;接着通过链式法则把误差逐层传回;最后沿着能让损

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读