Django之Django模板与Jinja2模板的使用

link之家
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
配置模板目录

在工程中创建模板目录 templates ，接着在 settings.py 配置文件中修改 TEMPLATES 配置项的 DIRS 值，指定模板目录位置。
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',
在templates目录中新建一个模板文件，如index.html。在模板中，使用{{ }}语法访问变量。
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Title</title>
</head>
    <h3>{{ user }}</h3>
    <h3>{{ user.name }}</h3>
    <h3>{{ address }}</h3>
    <h3>{{ address.0 }}</h3>
</body>
</html>
通过loader.get_template(模板文件在模板目录中的相对路径) 找到返回模板对象
使用模板对象.render(context=None, request=None)进行渲染模板，然后返回渲染后的值
from django.http import HttpResponse
from django.template import loader
def index(request):
    # 获取模板
    template = loader.get_template('index.html')
    context = {'user': {'name': '小白', 'age': 20}, 'address': [1, 2, 3]}
    # 渲染模板
    return HttpResponse(template.render(context))
或者使用Django提供的render函数简写，render(request对象, 模板文件路径, 模板数据字典)
from django.shortcuts import render
def index2(request):
    context = {'user': {'name': '小白', 'age': 20}, 'address': [1, 2, 3]}
    return render(request, 'index.html', context)
在URLconf中定义一个URL模式，将URL映射到视图函数
urlpatterns = [
    re_path('index/', views.index, name='index'),
访问URL，即可看到渲染的index.html模板页面
Django的模板语法是一种简单且易于学习的语言，它使用一些特殊的标记和标签来创建动态HTML页面。
在模板中使用双花括号来访问变量。当模板渲染时，它会将变量替换为其对应的值。
变量名必须由字母、数字、下划线（不能以下划线开头）和点组成。
欢迎您，{{ user.username }}！
注释内容不会显示在最终生成的HTML中。注释可用于在模板中添加说明或注释。
{# 单行注释 #}
多行注释使用comment标签
{% comment %}
{% endcomment %}
FOR循环
for循环用于在模板中迭代数据，并将数据渲染到模板中。for循环使用{% %}括起来并包含一个嵌套的{{ }}变量。
    {% for item in address %}
    第{{ forloop.counter }}次循环,值： {{ item }} <br>
    {% empty %}列表为空或不存在时执行
    {% endfor %}
if语句用于在模板中测试条件，并根据条件显示特定内容。if语句使用{% %}括起来。
{% if user.age == 20 %}
    <a>age is 20</a>
{% elif user.age == 30 %}
    <a>age is 30</a>
{% else %}
    <a>age is null</a>
{% endif %}
{% if user.is_authenticated %}
  您已登录！
{% else %}
{% endif %}
运算符左右两侧不能紧挨变量或常量，必须有空格。
1.比较运算符
2.布尔运算符
过滤器用于修改变量的值，以便在渲染时呈现。它们以管道符号|分隔，并作为变量的后缀。
过滤器用于进行计算、转换操作，可以使用在变量、标签中。如果过滤器需要参数，则使用冒号:传递参数。
模板语法：
{{ 变量名 | 过滤器：可选参数 }}
基本使用：
显示大写的 my_var 值
{{ my_var|upper }} 
过滤管道可以被套接 ，即：一个过滤器管道的输出又可以作为下一个管道的输入
将第一个元素并将其转化为大写
{{ my_list|first|upper }}
有些过滤器有参数。 过滤器的参数跟随冒号之后并且总是以双引号包含
显示变量my_var的前30个词
{{ my_var|truncatewords:"30" }}
其他过滤器：
lower : 大写转换小写
upper : 小写转换大写
title  :  可以将字符串中首字母大写
safe : 禁用转义，告诉模板这个变量是安全的，可以解释执行
length : 长度，返回字符串包含字符的个数，或列表、元组、字典的元素个数。
{{ name|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秒"
slice : 使用 slice 过滤器可以获取序列（列表，元组等）的一个子序列
{{ some_list|slice:"1:4" }}
join : 使用 join 过滤器可以将列表中的每个元素连接成一个字符串。
{{ some_list|join:" / " }}
继承和区块
继承和区块用于在不同的模板之间共享代码和结构。基本的继承语法使用{% extends %}，而区块语法使用{% block %}和{% endblock %}。
如果发现在多个模板中某些内容相同，那么这些内容就可以定义到父模板中。
使用标签block进行定义，用于在父模板中预留区域，留给子模板填充差异性的内容。 为了可读性，建议给endblock标签写上名字，名字不能相同。父模板中也可以使用上下文中传递过来的数据。
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Title</title>
</head>
{% block header %}
    <div>预留区域,可以是默认内容，也可以没有内容</div>
{% endblock header %}
{% block foot %}
    <div>脚部默认区域</div>
{% endblock foot %}
</body>
</html>
子模板使用标签extends，写在子模板文件的第一行。子模版不用填充父模版中的所有预留区域，如果子模版没有填充，则使用父模版定义的默认值。
{% extends 'user/test.html' %}
{% block header %}
    {{ block.super }}
{% endblock header %}
{% block foot %}
    填充脚部区域
{% endblock foot %}
Jinja2模板
Jinja2是一个基于Python的、功能强大的Web模板引擎，其提供了许多有用的功能，如继承、条件渲染、迭代、宏、自动转义以及过滤器等。
django默认模板引擎功能不齐全,速度慢，jinja2宣称比django默认模板引擎快10-20倍。Django也支持jinja2。
安装jinja2模块
pip install jinja2
Jinja2模板引擎环境配置文件
在项目中创建 jinja2_env.py模板引擎环境配置文件
from django.templatetags.static import static
from django.urls import reverse
from jinja2 import Environment
def environment(**options):
    env = Environment(**options)
    env.globals.update({
        'static': static,
        'url': reverse,
    return env
配置Jinja2模板引擎
在settings.py文件中配置Jinja2模板引擎，接着指定Jinja2模板引擎环境
TEMPLATES = [
    	# 1.将django模板引擎修改为jinja2
        # 'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'BACKEND': 'django.template.backends.jinja2.Jinja2',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
        	# 2.指定修改过的环境变量
        	# 'environment': 'jinja2.Environment',# 默认存在
            'environment': 'demo.jinja2_env.environment',
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
使用Jinja2模板
定义一个视图
from django.http import HttpResponse
from django.template import loader
def index1(request):
    # 获取模板
    template = loader.get_template('user/index.html')
    context = {'user': {'name': '小白', 'age': 20}}
    # 渲染模板
    return HttpResponse(template.render(context))
Jinja2模板的模板语法与Django自带的模板使用语法类似。
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Title</title>
</head>
{{ user.name }}
{{ user.age }}
</body>
</html>
Jinja2过滤器
Jinja2提供了大量的过滤器来处理和转换模板变量
safe过滤器可以标记内容是安全的，即内容不应被转义或修改。
{{ var|safe }}
capitalize过滤器可以将文本的第一个字符大写。
{{ var|capitalize }}
lower过滤器可以将文本全部转换为小写。
{{ var|lower }}
upper过滤器可以将文本全部转换为大写。
{{ var|upper }}
title过滤器可以将单词的首字母转换为大写，而其他字符转换为小写。
{{ var|title }}
truncate过滤器可以将文本截断为指定长度，并在末尾添加省略号。
{{ var|truncate(20) }}
escape过滤器可以实现HTML、XML和URL的转义。
{{ var|escape }}
join过滤器可以将列表中的元素连接起来。
{{ var|join(', ') }}
default过滤器可以在值为空或不存在时提供一个默认值，避免出现模板错误。
{{ var|default('no value') }}
dictsort过滤器可以按字典顺序排序列表中的字典，也可以反转顺序。
{{ var|dictsort }}
自定义过滤器
Jinja2提供了一些内建的过滤器，同时也可以自定义过滤器
在jinja2_env.py文件中自定义过滤器
from jinja2 import Environment
def environment(**options):
	# 创建env实例
    env = Environment(**options)
    # 将自定义的过滤器添加到环境中
    # myFilterFun是过滤器函数，myFilter是过滤器名称 
    env.filters['myFilterFun'] = myFilter
    return env
# 自定义过滤器
def myFilter(val):
    if val == "Python":
        return "OK"
    else:
        return val
注释使用django原模板的admin应用及路由，否则将出现如下异常：
ERRORS:
?: (admin.E403) A 'django.template.backends.django.DjangoTemplates' instance must be configured in TEMPLATES in order to use the admin application.
INSTALLED_APPS = [
    # 'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 添加注册子应用
    'user.apps.UserConfig',
from django.urls import include, path
urlpatterns = [
    # path('admin/', admin.site.urls),
    # 配置只要是/user路径则匹配成功
    # path('user/', include('user.urls')),
    path('user/', include(('user.urls', 'user'), namespace='user'))
使用过滤器
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Title</title>
</head>
{{ "Python" | myFilterFun }}
{{ "Java" | myFilterFun }}
</body>
</html>
    CodeDevMaster
        全栈工程师
        158.3k
       粉丝




    
 
 目录
 收起
 
 
      Django模板
      配置模板目录
      FOR循环
      继承和区块
      Jinja2模板
      安装jinja2模块
      Jinja2模板引擎环境配置文件
      配置Jinja2模板引擎
      使用Jinja2模板
      Jinja2过滤器
      自定义过滤器
    
 
  相关推荐
 使用Helm部署Wikijs
  1.1k阅读
  · 
 0点赞FastAPI入门
  38阅读
  · 
 0点赞Python 为什么没有 main 函数？为什么我不推荐写 main 函数？
  5.5k阅读
  · 
 3点赞带你了解关于FastAPI快速开发Web API项目中的模板和Jinja
  619阅读
  · 
 5点赞pydantic模块简介和定义方法
  435阅读
  · 
 16点赞
 
   友情链接：
 
        重生九零，锦鲤医妻撩夫上瘾
        天降甜妻：墨少爱不释手
        穿书七零假千金，一夜团宠暴富了
        洪荒：我是一个摸鱼的道人