4.django-模板
阅读原文时间:2023年07月08日阅读:5

在django中,模板引擎(DTL)是一种可以让开发者将服务端数据填充到html页面中的完成渲染的技术

模板引擎的原理分为以下三步:

  • 在项目配置文件中指定保存模板文件的的模板目录,一般设置在项目根目录或者子应用目录下

  • 在模板目录下创建对应的模板文件

  • 在视图函数中通过render函数绑定模板文件和需要渲染的数据

1.模板目录

在简单的项目中,我们通常在项目的根目录下创建名为templates的文件夹,并在配置文件中设置模板目录

TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [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',
],
},
},
]

如果是多app的情况下,我们不仅要设置主模板目录,还要在每个app下创建对应的templates,包含该子app所需要的模板文件

TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [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',
],
},
},
]

提示:在使用模板的时候,django会到主模板目录下寻找,找不到会按照顺序到已注册的项目下的模板目录中寻找

简单案例

路由

from django.contrib import admin
from django.urls import path, include
from apps.app01 import views

urlpatterns = [
path('admin/', admin.site.urls),
path('book/',views.index)
]

视图

def index(request):
return render(request, 'app01/index.html')

模板



Title


2.render函数的本质

render函数的本质就是将模板文件中的所有变量替换成后端数据,生成一个html页面,也就是纯文本,响应给客户端

模板文件 & html页面的区别

模板文件是含有特殊语法的html文件,这个语法可以被django的DTL编译,将数据传进,实现动态话,渲染之后的模板文件也就是一个普通的html文件了

开发中我们常将普通的html称之为静态文件,将模板文件称之为动态文件

视图函数

def index(request):
name = 'kunmzhao'
return render(request, 'app01/index.html', {'name':name}) # 将数据传递给模板文件

模板文件



Title

{{ name }}

#含有模板语法

渲染之后的html文件



Title

kunmzhao

# 渲染之后

3.模板语法

变量渲染可以将对象原封不动的渲染在页面

def index(request):
# 字符串
name = 'kunmzhao'
# 数字
age = 18
# 列表
course = ['语文', '数学', '英语']
# 元组
hobby = ('篮球', '足球')
# 字典
parents = {'father': 'mayun', 'mother': "dongmingzhu"}
# 集合
teachers = {'alex', 'victor'}

return render(request, 'app01/index.html', {  
    'name': name,  
    'age': age,  
    'course': course,  
    'hobby': hobby,  
    'parents': parents,  
    'teachers': teachers,  
}

句点符就可以访问对象中的属性

from django.shortcuts import render, HttpResponse

Create your views here.

class Animal(object):
def __init__(self, name, age):
self.name = name
self.age = age

def index(request):
# 字符串
name = 'kunmzhao'
# 数字
age = 18
# 列表
course = ['语文', '数学', '英语']
# 字典
parents = {'father': 'mayun', 'mother': "dongmingzhu"}

# 对象  
dog = Animal('rubby', 3)

return render(request, 'app01/index.html', {  
    'name': name,  
    'age': age,  
    'course': course,  
    'parents': parents,  
    'dog': dog  
}  
              )



Title

{{ name }}

{{ age }}

{{ course.0 }}

# 访问列表第几个元素

{{ course.1 }}

{{ course.2 }}

{{ parents.father}}

# 访问字典中键对应的值

{{ parents.mother }}

{{ dog.name }}

# 访问对象发的属性

{{ dog.age }}


3.2.1 内置过滤器

内置过滤器最多有一个参数

语法:

{{obj|过滤器名称:过滤器参数}}

过滤器

用法

代码

last

获取列表/元组的最后一个成员

{{liast | last}}

first

获取列表/元组的第一个成员

{{list|first}}

length

获取数据的长度

{{list | length}}

defualt

当变量没有值的情况下, 系统输出默认值,

{{str|default="默认值"}}

safe

让系统不要对内容中的html代码进行实体转义

{{htmlcontent| safe}}

upper

字母转换成大写

{{str | upper}}

lower

字母转换成小写

{{str | lower}}

title

每个单词首字母转换成大写

{{str | title}}

date

日期时间格式转换

{{ value| date:"D d M Y" }}

cut

从内容中截取掉同样字符的内容

{{content | cut:"hello"}}

list

把内容转换成列表格式

{{content | list}}

add

加法

{{num| add}}

filesizeformat

把文件大小的数值转换成单位表示

{{filesize | filesizeformat}}

join

按指定字符拼接内容

{{list| join("-")}}

random

随机提取某个成员

{list | random}}

slice

按切片提取成员

{{list | slice:":-2"}}

truncatechars

按字符长度截取内容

{{content | truncatechars:30}}

truncatewords

按单词长度截取内容

同上

def index(request):
name = 'kunmzhao'
hobby = ['篮球', '足球']

return render(request, 'app01/index.html', {  
    'name': name,  
    'hobby': hobby,  
}  
      )



Title

{{ name|upper }}

{{ hobby|first }}

{{ hobby|last }}



3.2.2 自定义过滤器

内置的过滤器可能没办法满足开发需求,django中支持使用自定义的过滤器

  • 确保定义过滤器所在的app已经注册

  • 在注册的app下创建templatetags的模块包

  • 创建py文件

  • 在文件中自定义过滤器

    from django import template

    register = template.Library()

    自定义过滤器

    @register.filter()
    def mobile(content):
    return content[:3] + "*****" + content[-3:]

  • 在模板中load过滤器并使用

    {% load my_filter %} # 导入自定义的过滤器



    Title

    {{ phone|mobile }}

    # 使用过滤器

3.3.1 if

语法:

{% if 条件 %}
{%endif %}

视图

def index(request):
score = 80
return render(request, 'app01/index.html', {
'score': score,
}
)

模板


Title {% if score > 90 %}

成绩优秀啊

{% elif score > 80 %}

成绩良好

{% else %}

成绩一般

{% endif %}

3.3.2 for

语法

{% for i in iter %}
{%endfor %}

for标签中常用的方法

forloop.counter : 从1开始每次循环自增1
forloop.counter0 : 从0开始每次循环自增1
forloop.first : 是否是第一次循环
forloop.last : 是否是最后一循环

视图

def index(request):
hobby = ['篮球', '足球', '乒乓球']
return render(request, 'app01/index.html', {
'hobby': hobby,
}
)

模板



Title

{% for foo in hobby %}

<p><span>{{ forloop.counter }}</span>{{ foo }}</p>  

{% endfor %}

4.模板自定义

  • filter

    见自定义过滤器
    参数:1-2个

  • Simple_tag

    返回文本
    参数:无限制

  • Inclusion_tag

    返回html片段
    参数无限制

定义

# encoding:utf-8

author:kunmzhao

email:1102669474@qq.com

from django import template

register = template.Library()

自定义过滤器

@register.filter()
def mobile(content):
return content[:3] + "*****" + content[-3:]

自定义simple_tag

@register.simple_tag()
def mytag(a1, a2):
return a1 + a2

自定义inclusion_tag

@register.inclusion_tag("app01/menu.html")
def my_inclusion():
return {'name': 'kunmzhao', 'age': 18}

模板

{% load my_filter %}



Title

{{ phone |mobile }}

# 使用自定义的过滤器

{% mytag 100 200 %}

# 使用自定义的tag函数

{% my\_inclusion %}

# 使用自定义的inclusion_tag


menu.html

name={{ name }} age={{ age }}

5.模板继承和导入

{% include "模板文件名"%} # 模板嵌入
{% extends "base.html" %} # 模板继承

语法
{%entends 模板文件%} # 继承指定的模板文件

{% block 名称 %} # 填充模板中的某一个block

{% endblock %}

视图

def index(request):
return render(request, 'app01/header.html')

模板header.html

{% extends 'app01/index.html' %}
{% block body%}

不畏浮云遮望眼,只缘身在最高层

{% endblock %}

模板index.html


Title {% block css %} {# css样式 #} {% endblock %} {% block body %} {# 内容填充 #} {% endblock %}

{% include 片段文件名%}

视图

def index(request):
return render(request, 'app01/header.html', {'name': 'kunmzhao', 'age': 18})

模板menu.html

name={{ name }} age={{ age }}

模板header.html

{% extends 'app01/index.html' %}
{% block body %}

不畏浮云遮望眼,只缘身在最高层

{% include 'app01/menu.html' %} # 导入片段
{% endblock %}

6.静态文件

我们通常会将前端的css, js等代码发在app对应的static目录下,我们在模板中导入css或者js等代码的时候,引入{ %load static %}

跟templates类似,在多app下,我们通常会在每个app下创建一个static的文件夹,再创建对应app名字的文件件,将该app下使用的静态文件放在该目录