django模板层模板语法过滤器模板导入与继承

最新推荐文章于 2023-10-23 15:10:22 发布

i0208

最新推荐文章于 2023-10-23 15:10:22 发布

阅读量382

点赞数

分类专栏： Django框架

本文链接：https://blog.csdn.net/Waller_/article/details/104198069

版权

Django框架专栏收录该内容

25 篇文章 1 订阅

订阅专栏

django templates 在settings中的配置详情

django的模板=HTML代码+模板语法

存放于templates目录下的html文件称之为模板文件，如果我们想要返回的html页面中的数据是动态的，那么必须在html页面中嵌入变量，这便用到了django的模板语法，具体来说，django的模板语法有以下重点

{{ }} 变量相关
{% %} 逻辑相关

模板语法之变量

基本使用

如果html代码中的数据不是固定死的，而是动态变化的，则必须在html中嵌入变量，为此，模板语法提供了变量的概念，允许我们在html代码中嵌入变量，我们只需要在视图函数中用render方法为html文件中指定的变量赋值即可，具体用法如下

test.html

<body>
<p>{{ msg }}</p>
<p>{{ dic }}</p>
<p>{{ obj }}</p>
<p>{{ li }}</p>
</body>

我们需要在视图函数中为模板test.html的变量名msg、li、dic、obj、obj_li赋值

views.py

from django.shortcuts import render

def test(request):
    # 传给模板的变量值可以是任意python类型，如下
    msg='hello world'
    dic={'k1':1,'k2':2}
    class Person(object):
        def __init__(self,name,age):
            self.name=name
            self.age=age

    obj=Person('xxx',18)
    li = [1,'aaa',obj]

    return render(request,'test.html',{'msg':msg,'dic':dic,'obj':obj,'li':li})
    # 注意：
    1、render函数的第三个参数包含了要传给模板的变量值，是一个字典类型，该字典中的key必须与模板文件中的变量名相对应，
render函数会去templates目录下找到模板文件，然后根据字典中的key对应到模板文件中的变量名进行赋值操作，
最后将赋值后的模板文件内容返回给浏览器
    2、可以将render函数的第三个参数简写为locals(),如下
    return render(request,'test.html',locals()) 
    #locals()会将函数test内定义的名字与值转换为字典中的k与v

注意:

1.通过字典的键值对指名道姓的一个个传,可多传或少传
return render(request, 'reg.html', {'n':n, 'f':f, ...})
2.locals() 会将它所在的名称空间中的所有名字都传递给指定模板
return render(request, 'reg.html', locals())  # 缺点:易造成资源浪费

1.容器数据类型:前端获取后端传过来的容器类型的内部元素,统一采用句点符(.)
2.函数:后端传函数名到前端，会自动加括号调用，但是不支持传参
3.类:后端传对象到前端，就相当于打印了这个对象,该对象可以通过点方法拿到类中方法的返回值(类名也一样)

深度查询之句点符的使用

当视图函数传给模板的值中包含多个元素时，若想取出其中的单个元素，就必须使用句点符了。

句点符既可以引用容器类型的元素，也可以引用对象的方法

test.html

<body>

<!--调用字符串对象的upper方法，注意不要加括号-->
<p>{{ msg.upper }}</p>

<!--取字典中k1对应的值-->
<p>{{ dic.k1 }}</p>

<!--取对象的name属性-->
<p>{{ obj.name }}</p>

<!--取列表的第2个元素,然后变成大写-->
<p>{{ li.1.upper }}</p>

<!--取列表的第3个元素，并取该元素的age属性-->
<p>{{ li.2.age }}</p>

</body>

过滤器

过滤器类似于python的内置函数，用来把视图传入的变量值加以修饰后再显示，具体语法如下

{{ 变量名|过滤器名:传给过滤器的参数 }}

原理:会将 | 前面的当做第一个参数传入标签中

常用内置过滤器

default

作用：如果一个变量值是False或者为空，使用default后指定的默认值，否则，使用变量本身的值，如果value=’‘则输出“nothing”

{{ value|default:"nothing" }}

length

作用：返回值的长度。它对字符串、列表、字典等容器类型都起作用，如果value是 ['a', 'b', 'c', 'd']，那么输出是4

{{ value|length }}

filesizeformat

作用：将值的格式化为一个"人类可读的"文件尺寸(如13KB、4.1 MB、102bytes等等），如果 value 是 12312312321，输出将会是 11.5 GB

{{ value|filesizeformat }}

date

作用：将日期按照指定的格式输出，如果value=datetime.datetime.now(),按照格式Y-m-d则输出2019-02-02

{{ value|date:"Y-m-d" }}

slice

作用：对输出的字符串进行切片操作，顾头不顾尾,如果value=“xionger“，则输出"xi"

{{ value|slice:"0:2" }}

truncatechars

作用：如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾，如果value=”hello world xionger 嘎嘎“，则输出"hello...",注意8个字符也包含末尾的3个点

{{ value|truncatechars:8 }}

truncatewords

作用：同truncatechars，但truncatewords是按照单词截断，注意末尾的3个点不算作单词，如果value=”hello world egon 嘎嘎“，则输出"hello world ..."

{{ value|truncatewords:2 }}

safe

作用：出于安全考虑，Django的模板会对HTML标签、JS等语法标签进行自动转义,例如value="<script>alert(123)</script>"，模板变量{{ value }}会被渲染成<script>alert(123)</script>交给浏览器后会被解析成普通字符”<script>alert(123)</script>“，失去了js代码的语法意义，但如果我们就想让模板变量{{ value }}被渲染的结果又语法意义，那么就用到了过滤器safe，比如value='<a href="https://www.baidu.com">点我啊</a>'，在被safe过滤器处理后就成为了真正的超链接，不加safe过滤器则会当做普通字符显示’<a href="https://www.baidu.com">点我啊</a>‘

{{ value|safe }}

其他过滤器:

过滤器	描述	示例
upper	以大写方式输出	{{ user.name \| upper }}
add	给value加上一个数值	{{ user.age \| add:”5” }}
addslashes	单引号加上转义号
capfirst	第一个字母大写	{{ ‘good’\| capfirst }} 返回”Good”
center	输出指定长度的字符串，把变量居中	{{ “abcd”\| center:”50” }}
cut	删除指定字符串	{{ “You are not a Englishman” \| cut:”not” }}
date	格式化日期
default	如果值不存在，则使用默认值代替	{{ value \| default:”(N/A)” }}
default_if_none	如果值为None, 则使用默认值代替
dictsort	按某字段排序，变量必须是一个dictionary	{% for moment in moments \| dictsort:”id” %}
dictsortreversed	按某字段倒序排序，变量必须是dictionary
divisibleby	判断是否可以被数字整除	`{{ 224 \| divisibleby:2 }} 返回 True`
escape	按HTML转义，比如将”<”转换为”&lt”
filesizeformat	增加数字的可读性，转换结果为13KB,89MB,3Bytes等	`{{ 1024 \| filesizeformat }} 返回 1.0KB`
first	返回列表的第1个元素，变量必须是一个列表
floatformat	转换为指定精度的小数，默认保留1位小数	{{ 3.1415926 \| floatformat:3 }} 返回 3.142 四舍五入
get_digit	从个位数开始截取指定位置的数字	{{ 123456 \| get_digit:’1’}}
join	用指定分隔符连接列表	{{ [‘abc’,’45’] \| join:’’ }} 返回 abc45
length	返回列表中元素的个数或字符串长度
length_is	检查列表，字符串长度是否符合指定的值	{{ ‘hello’\| length_is:’3’ }}
linebreaks	用或标签包裹变量	{{ “Hi\n\nDavid”\|linebreaks }} 返回 Hi David
linebreaksbr	用标签代替换行符
linenumbers	为变量中的每一行加上行号
ljust	输出指定长度的字符串，变量左对齐	{{‘ab’\|ljust:5}}返回 ‘ab ’
lower	字符串变小写
make_list	将字符串转换为列表
pluralize	根据数字确定是否输出英文复数符号
random	返回列表的随机一项
removetags	删除字符串中指定的HTML标记	{{value \| removetags: “h1 h2”}}
rjust	输出指定长度的字符串，变量右对齐
slice	切片操作，返回列表	{{[3,9,1] \| slice:’:2’}} 返回 [3,9] `{{ 'asdikfjhihgie' \| slice:':5' }} 返回 ‘asdik’`
slugify	在字符串中留下减号和下划线，其它符号删除，空格用减号替换	`{{ '5-2=3and5 2=3' \| slugify }} 返回 5-23and5-23`
stringformat	字符串格式化，语法同python
time	返回日期的时间部分
timesince	以“到现在为止过了多长时间”显示时间变量	结果可能为 45days, 3 hours
timeuntil	以“从现在开始到时间变量”还有多长时间显示时间变量
title	每个单词首字母大写
truncatewords	将字符串转换为省略表达方式	{{ 'This is a pen' \| truncatewords:2 }}返回``This is ...
truncatewords_html	同上，但保留其中的HTML标签	{{ '<p>This is a pen</p>' \| truncatewords:2 }}返回``<p>This is ...</p>
urlencode	将字符串中的特殊字符转换为url兼容表达方式	{{ ‘http://www.aaa.com/foo?a=b&b=c’ \| urlencode}}
urlize	将变量字符串中的url由纯文本变为链接
wordcount	返回变量字符串中的单词数
yesno	将布尔变量转换为字符串yes, no 或maybe	`{{ True \| yesno`

模板语法之标签

标签是为了在模板中完成一些特殊功能,语法为{% 标签名 %}，一些标签还需要搭配结束标签 {% endtag %}

for 循环

{% for foo in l %}
    <p>{{ foo }}</p>
    <p>{{ forloop }}</p>  
{% endfor %}

empty

当你的for循环对象为空的时候会自动走empty代码块儿的内容

{% for foo in l %}
    <p>{{ foo }}</p>
    {% empty %}
    <p>你给我的容器类型是个空啊，没法for循环</p>
{% endfor %}

案例:

url.py

urlpatterns = [
    re_path(r'^test/',views.test)
]

view.py

def test(request):
    names=['xxx','yyy']
    dic={'name':'xxx','age':18,'sex':'male'}

    list1=[]

    return render(request,'test.html',locals())

test.html

<body>
<hr>
{% for name in names %}
    <p>{{ forloop.counter0 }} {{ name }}</p>
{% endfor %}
<!--
输出结果为：
0 xxx
1 yyy
-->

<hr>
{% for name in names reversed %}
    <p>{{ forloop.revcounter0 }} {{ name }}</p>
{% endfor %}
<!--
输出结果为：
1 yyy
0 xxx
-->

<hr>
{% for k,v in dic.items %}
    <p>{{ forloop.counter }} {{ k }} {{ v }}</p>
{% endfor %}
<!--
输出结果为：
1 name xxx
2 age 18
3 sex male
-->

<hr>
{% for item in list1 %}
    <p>{{ item }}</p>
    {% empty %}
        <p>sorry,no value here</p>
{% endfor %}
<!--
输出结果为：
sorry,no value here
-->

</body>

if 判断

{% if 条件 %}条件为真时if的子句才会生效，条件也可以是一个变量，if会对变量进行求值，在变量值为空、或者视图没有为其传值的情况下均为False

{% if num > 100 or num < 0 %}
    <p>无效</p>
{% elif num > 80 and num < 100 %}
    <p>优秀</p>
{% else %}
    <p>凑活吧</p>
{% endif %}

if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断。

案例:

urls.py

urlpatterns = [
    # 输入http://127.0.0.1:8008/或者http://127.0.0.1:8008/index/都会转发给视图函数index
    re_path(r'^$',views.index),
    re_path(r'^index/$',views.index),
    
    re_path(r'^login/',views.login),

]

views.py

from django.shortcuts import render

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

def login(request):
    if request.method == 'GET':
        return render(request,'login.html')

    name=request.POST.get('name')
    pwd=request.POST.get('pwd')
    if name == 'egon' and pwd == '123':
        current_user=name
        return render(request,'index.html',locals())
    else:
        msg='账号或密码错误'
        return render(request,'login.html',locals())

index.html

<body>

<h3>首页</h3>
<!--
如果用户已经登录，则current_user变量有值，if判断结果为真，会打印变量current_user的值，为当前登录的用户名
如果用户没有登录，则current_user变量无值，if判断结果为假，会打印a标签要求用户先登录
-->
{% if current_user %}
    <p>当前登录用户为：{{ current_user }}</p>
{% else %}
    <p><a href="/login/">请先登录</a></p>
{% endif %}

</body>

<body>

<form action="" method="POST">
    {% csrf_token %}
    <p>用户名：<input type="text" name="name"></p>
    <p>密码：<input type="password" name="pwd"></p>
    <p><input type="submit" value="提交"></p>
</form>
<!--输错账号密码时的提示信息-->
<p style="color: red">{{ msg }}</p>
</body>

with标签

with标签用来为一个复杂的变量名起别名,如果变量的值来自于数据库，在起别名后只需要使用别名即可，无需每次都向数据库发送请求来重新获取变量的值

{% with li.1.upper as v %}
    {{ v }}
{% endwith %}

csrf_token标签

当用form表单提交POST请求时必须加上标签{% csrf_token%}，该标签用于防止跨站伪造请求

<form action="" method="POST">
    {% csrf_token %}
    <p>用户名：<input type="text" name="name"></p>
    <p>密码：<input type="password" name="pwd"></p>
    <p><input type="submit" value="提交"></p>
</form>

具体工作原理为：
1、在GET请求得到form表单时，标签{% csrf_token%}会被渲染成一个隐藏的input标签，该标签包含了由服务端生成的一串随机字符串,如<input type="hidden" name="csrfmiddlewaretoken" value="dmje28mFo...OvnZ5">
2、在使用这个form表单提交POST请求时，会提交上述随机字符串，服务端在接收到该POST请求时会对比该随机字符串，是不是后端发出去的那组随机字符串,对比成功则处理该POST请求，否则拒绝，以此来确定客户

自定义过滤器和标签

# 自定义必需要做的三件事
1.在应用名下新建一个名为templatetags文件夹(必须叫这个名字)
2.在该新建的文件夹内新建一个任意名称的py文件
3.在该py文件中需要固定写下面两句代码:
    from django import template
    register = template.Library()
    
注意: 必须先在需要使用的html页面加载你的py文件 {% load mytag %}
     自定义过滤器或标签必须重新启动django方可生效

案例:

mytag.py

from django import template
register = template.Library() # 注意变量名必须为register,不可改变

#1、自定义过滤器
@register.filter
def my_multi_filter(v1 ,v2): # 自定义的过滤器只能定义最多两个参数，针对{{ value1 | filter_multi:value2 }}，参数传递为v1=value1,v2=value2
    return  v1 * v2

#2、自定义标签
@register.simple_tag
def my_multi_tag(v1, v2): # 自定义的标签可以定义多个参数
    return v1 * v2

#3、自定义标签扩展之mark_safe
# 注释：我们可以用内置的标签safe来让标签内容有语法意义，如果我们想让自定义标签处理的结果也有语法意义，则不能使用内置标签safe了，需要使用mark_safe，可以实现与内置标签safe同样的功能
from django.utils.safestring import mark_safe

@register.simple_tag
def my_input_tag(id, name):
    res = "<input type='text' id='%s' name='%s' />" % (id, name)
    return mark_safe(res)

test.html

<body>

<!--必须先加载存有自定义过滤器和标签的文件-->
{% load mytag %}

<!--salary的值为10，经过滤器my_multi_filter的处理结果为120-->
{{ salary|my_multi_filter:12 }}

<!--结果为2-->
{% my_multi_tag 1 2 %}

<!--
结果为一个input标签，该表的属性id="inp1" name="username"
注意：input的属性值均为字符串类型，所以my_input_tag后的两个值均为字符串类型
-->
{% my_input_tag "inp1" "username" %} 

</body>

对比自定义标签与自定义过滤器

#1、自定义过滤器只能传两个参数，而自定义标签却可以传多个参数

#2、过滤器可以用于if判断，而标签不能
{% if salary|my_multi_filter:12 > 200 %}
    <p>优秀</p>
{% else %}
    <p>垃圾</p>
{% endif %}

模板的导入和继承

在实际开发中，模板文件彼此之间可能会有大量冗余代码，为此django提供了专门的语法来解决这个问题,主要围绕三种标签的使用：include标签、extends标签、block标签，详解如下

模板导入 include

作用：在一个模板文件中，引入/重用另外一个模板文件的内容

如: 当你写了一个特别好看的form表单/列表标签等,可以将它当成一个模块,哪个地方需要,就直接导入使用即可

{% include '模版名称' %}

使用

<!--将一段html当做模块的方式导入到另一个html展示-->
{% include 'beautiful.html' %}

模板继承 extends / block

当多个页面整体的样式都大差不差的情况下,可以设置一个模板文件,在该模板文件中,使用block块划分多个区域,
之后子版在使用模板的时候,可以通过block块的名字,来选定到底需要修改哪一部分区域

使用:

<!--第一步: 首先需要在被继承的模板中划分多个区域-->
{% block 给区域起的名字 %}
    区域代码块
{% endblock %}

<!--第二步:继承模板所有的内容-->
{% extends 'home.html' %}

<!--第三步:根据block块的名字修改指定区域的内容-->
{% block content %}
<h1>登录页面</h1>
    <form action="">
        <p>username:<input type="text" class="form-control"></p>
        <p>password:<input type="text" class="form-control"></p>
        <input type="submit" class="btn btn-success">
    </form>
{% endblock %}

<!--ps:通常情况下一个模板中应该至少有三块,一般情况下,模板上的block越多,页面的可扩展性就越强-->
{% block css %}
    页面css代码块
{% endblock %}

{% block content %}
    页面主体内容
{% endblock %}

{% block js %}
    页面js代码块
{% endblock %}

i0208

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
django模板层模板语法过滤器模板导入与继承

django的模板=HTML代码+模板语法存放于templates目录下的html文件称之为模板文件，如果我们想要返回的html页面中的数据是动态的，那么必须在html页面中嵌入变量，这便用到了django的模板语法，具体来说，django的模板语法有以下重点{{ }} 变量相关{% %} 逻辑相关模板语法之变量基本使用如果html代码中的数据不是固定死的，而是动态变化的...
复制链接

扫一扫