django模板层(templates)

1.基础部分

  通过使用模板,就可以在URL中直接调用HTML,它还是松耦合的,灵活性强,而且更容易维护

  而且可以将变量通过一定的方式嵌入到HTML中,最终渲染到页面,总的来说基于模板完成了数据与用户之间的交互

1.1模板HTML中的变量

  用两个大括号括起来的文字(例如  {{ person_name }} )称为  变量 (variable)

url部分

urlpatterns = [
    path("third/",views.indexs)
]

views部分

import datetime
def indexs(request):
    hel = "hello"
    lis_year = [18, 22, 32]  # 列表
    dic = {"name": "luffy", "age": 18}  # 字典
    date = datetime.datetime.now() # 日期对象

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

    person_1 = Person("zoro")  # 自定义类对象
    person_2 = Person("sanzhi")
    person_3 = Person("robin")
    person = [person_1, person_2, person_3]

    return render(request, "index.html",
        {"hel":hel,"l": lis_year, "dic": dic, "ship_data": date, "person_list": person})

templates部分(名称index.html)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h4>{{ hel }},</h4>
    <h4>my name is {{ dic.name.upper }}.</h4>  {# 句点符引用对象的方法 #}
    <h4>I'm  {{ l.0 }}'s old.</h4>   {# 视图对象索引0的值 #}
    <h4>and my born year is {{ ship_data|date:"y-m-d" }}.</h4>
    {% for name in person_list %}   {# 遍历每一个元素 #}
    <h4> my partner is {{ name.name }}</h4>  {# 类对象列表 #}
    {% endfor %}    {# 必须要包含结束标志 #}
</body>
</html>

# 注意这里调用字符串的方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数;你只能调用不需参数的方法

最终效果

1.2模板语法

 1.2.1 过滤器模板

default

default		# 如果一个变量是false或为空,使用给定默认值,否则使用变量的值
{{value|deafult:"666"}}  

 length

length 		# 返回值的长度,如 value 是 ['a', 'b', 'c', 'd'],那么输出是 4
{{ value|length }}

filesizeformat

filesizeformat	# 将值格式化为一个可读的文件尺寸,如 value 是 123456789,输出将会是 117.7 MB
{{ value|filesizeformat }}

 date

date 如value=datetime.datetime.now()	
{{ value|date:"Y-m-d" }} 

 slice 

slice 	# 切片
{{ value|slice:"2:-1" }}

 truncatechars

truncatechars	# 截断,如果字符串字符多于指定的字符数量,那么会被截断。截断的字符串将以可翻译的省略号序列(“...”)结尾	参数:要截断的字符数
{{ value|truncatechars:9 }}
<p>截断字符:{{ content|truncatechars:20 }}</p>
<p>截断单词:{{ content|truncatewords:4 }}</p>

 safe

safe 	# django会对模板中的语法自动转移,但是出于安全考虑,对于一些具有带链接跳转的功能标签则不会进行转义(如a标签)
{{value|safe}}

 这里给演示一下safe的用法

url部分

from app01 import views
urlpatterns = [
    path('admin/', admin.site.urls),
    path('views/',views.views)

views部分

  这里一开始我以为value这块是写在模板中,但是不是的,他属于视图部分,只是在模板这里添加了{{ value|safe}}这一步

def views(request):
    lis = ['das','two','three','four']
    value = "<a href='http://www.baidu.com'>click</a>"
    
    # 这里使用locals直接将上面的参数封装成了字典形式
    return render(request,'test.html',locals())
    # return render(request,'test.html',{"lis":lis,"value":value})

templates部分(test.html)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h3>字典:{{ lis|slice:'1:-1' }}</h3>
    {{ value|safe }}
</body>
</html>

 标签模板

for标签

遍历每一个元素
{% for person in person_list %}
    <p>{{ person.name }}</p>
{% endfor %}

 # 可以利用{% for obj in list reversed %}反向完成循环 

遍历一个字典

{% for key,val in dic.items %}
    <p>{{ key }}:{{ val }}</p>
{% endfor %}

 # 这里循环序号可以通过{{forloop}}显示 

forloop.counter            The current iteration of the loop (1-indexed)
forloop.counter0           The current iteration of the loop (0-indexed)
forloop.revcounter         The number of iterations from the end of the loop (1-indexed)
forloop.revcounter0        The number of iterations from the end of the loop (0-indexed)
forloop.first              True if this is the first time through the loop
forloop.last               True if this is the last time through the loop

forloop.last 是一个布尔值;在最后一次执行循环时被置为True。 一个常见的用法是在一系列的链接之间放置管道符(|)

另一个用途是为列表的每个单词加上逗号,把|换为逗号即可

{% for link in links%}
	{{link}}
	{% if not forloop.last%}|{% endif %}
{% endfor %}

效果:
Link1 | Link2 | Link3 | Link4

for...empty

# 在给出的组是空的或者没有被找到时,可以有所操作。
{% for person in person_list %}
    <p>{{ person.name }}</p>

{% empty %}
    <p>sorry,no person here</p>
{% endfor %}  

 if标签

# 对一个变量进行求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),对应的内容块会输出
{% if num > 100 or num < 0 %}
    <p>无效</p>
{% elif num > 80 and num < 100 %}
    <p>优秀</p>
{% else %}
    <p>凑合</p>
{% endif %}  

 with

# 用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用
{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

csrf_token 

csrf_token 	# 该标签用于跨站请求伪造保护

 相关例子示例:

views部分

def temps(request):
    lis = [10,20,30,50]
    dic = {"name":"luffy","age":18}
    lis =  ['one','two','three','four']
    num = 80
    login_user = 66
    return render(request,'test.html',locals())

templates部分(test.html)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    {% for num in lis %}
        <h3> {{ num|add:100 }}</h3>   {# 这里可以加减,带负号即可,没有乘除 #}
    {% endfor %}


    {% for k,v in dic.items %}      {# 注意这里是dic.items #}
        <h3>{{ k }}:{{ v }}</h3>
    {% endfor %}


    {% for temp in lis %}
        <h3>{{ forloop.counter }}{{ temp }}</h3>   {# 从1开始排 #}
    {% endfor %}


    {% if num >= 80 and num < 100 %}  {# 注意空格,不然会飘红 #}
        <h3>优秀</h3>
    {% elif num >= 60 and num < 80 %}
        <h3>良好</h3>
    {% elif num < 60 %}
        <h3>不及格</h3>
    {% else %}
        <h2>出错啦</h2>
    {% endif %}


    <hr>
    {% if login_user %}
        <p>{{ login_user.name }}</p>
        <a href="">注销</a>
        <a href="">修改密码</a>
    {% else %}
        <a href="">登陆</a>
        <a href="">注册</a>
    {% endif %}
    <hr>


    <form action="" method="post">
        {% csrf_token %}    {# 用于伪造保护,否则django会拒收报forbidden #}
    <input type="submit">
    </form>
</body>
</html>

效果

 2. 自定义标签和过滤器

 自定义标签和过滤器两者样式相同,这里一起演示

基本配置要求:

1.在settings中的INSTALLED_APPS配置当前app,不然django无法找到自定义的simple_tag.不过这里一般情况django都为我们配置好了

2.在app中创建templatetags模块(模块名只能是templatetags)

3.在该模块下创建任意名称的py文件(我用的是tags.py),它用于加载标签。注意里面还应该有一个__init__.py文件(用于告诉Python这是包含了一个Python代码的包)

tags.py文件

from django import template
from django.utils.safestring import mark_safe   # 注意导入路径

# 实例化一个对象,它属于模块级变量
register = template.Library()

# 给模板增加一个乘法装饰器
@register.filter
def temp_multi(x1,x2):
	return x1*x2

# 多个参数相乘
@register.simple_tag
def simple_temp_multi(x1,x2,x3):
	return x1*x2*x3

# 自定义标签
@register.filter
def my_input(href):
	result = "<a href= %s >click</a>" % href
	return mark_safe(result)  

  views部分

from django.shortcuts import render

# Create your views here.

def views(request):
	num = 5
	return render(request,'tests.html',locals())

 templates部分(tests.html)

  这里面很重要的就是 {% load tags %} 这步,这一步就把tags.py模块加载进来的。{% load %} 标签检查 INSTALLED_APPS 中的设置,仅允许加载已安装的Django应用程序中的模板库。 这是一个安全特性;它可以让你在一台电脑上部署很多的模板库的代码,而又不用把它们暴露给每一个Django安装。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p>自定义过滤器</p>
    {# 这里load的是templatetags下创建的文件名称,和导入模块类似 #}
    {% load tags %} 
    {# 后面只能放一个参数,num相当x1,属于变量,2代表x2,属于默认参数 #}
    {{ num|temp_multi:2}}
    <br>
    {# 如果多个参数相乘,可以使用register.simple_tag装饰器,注意实参间的间距 #}
    {# 这个需要注意的是不能放在if for语句中使用 #}
    {% simple_temp_multi 10 8 9 %}
    <br>
    {# 自定义标签 #}
    <p>{{ "https://www.cnblogs.com/LearningOnline/p/9221956.html"|my_input }}</p>

</body>
</html>

3.模板继承(extend)  

 django中模板继承的主要意义在于降低代码的冗余度这在后期项目中可是非常有意义的,可以大大缩减工作量

 这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航

具体用法,先在templates创建一个主模板,一般命名base.html

<!DOCTYPE html>
<html lang="en">
<head>
    <title>书库</title>
</head>

<body>
<div><a href="http://127.0.0.1:8008/index/">首页</a></div>
<div><a href="http://127.0.0.1:8008/authors/">作者</a></div>
<div><a href="http://127.0.0.1:8008/articles/">文章管理</a></div>

<div id="content">
    {% block content %}
        <h4>详细内容</h4>
    {% endblock %}
</div>
</body>
</html>

  该base.html模板定义了一个可以用于两列排版页面的简单HTML骨架,“子模版”的工作是用它们的内容填充空的blocks

  block 标签定义了可以被子模版内容填充的block。 block 告诉模版引擎: 子模版可能会覆盖掉模版中的这些位置。

这里我写了三个模板,这三个模板都与主模板存在同一位置:

index.html

{% extends "base.html" %}

{% block content %}
    <ul>
        {% for book in book_list %}
            <li>
                <h3>{{ book }}</h3>
            </li>
        {% endfor %}
    </ul>

{% endblock content %}

authors.html

{% extends "base.html" %}

{% block content %}
 {{ block.super }}
    {% for author in author_list %}
        <h2>{{ author }}</h2>
    {% endfor %}
{% endblock content %}

articles.html

{% extends "base.html" %}

{% block content %}
    {{ block.super }}
    <h3>增</h3>
    <h3>删</h3>
    <h3>改</h3>
    <h3>查</h3>
{% endblock content %}

#注意: extends 标签是这里的关键。它告诉模版引擎,这个模版“继承”了另一个模版。当模版系统处理这个模版时,首先,它将定位父模版。此外,父模板必须放在最顶端

我这里的views.py文件配置如下

from django.shortcuts import render

def index(request):
    book_list = ['巨人的陨落','你一生的故事','灵魂只能独行']
    return render(request, 'index.html', locals())

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

def authors(request):
    author_list = ['肯福莱特','特德姜','周国平']
    return render(request,'authors.html',locals())

urls.py文件配置如下

from app01 import views
urlpatterns = [
    path('admin/', admin.site.urls),
    path('index/',views.index),
    path('authors/', views.authors),
    path('articles/',views.articles),
]

运行效果,/index/路径下

/authors/路径下

 

 注意,包含 {{ block.super }}的html标签下,主模板下的h4有“”详细内容“”的字段有显示,被继承下来了

tips:

  • 如果模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况,模版继承都将无法工作。
  • base模版中设置越多的 {% block %} 标签越好。子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的内容,然后,只定义需要的那一个
  • 如果主模板{% block %} 标签下存在默认内容,此时如果你不想需要,或者需要改动,就可以使用{{ block.super }}
  • 为了提高可读性,可以给你的 {% endblock %} 标签一个 名字,如
{% block content %}
...
{% endblock content %}  

 

原文地址:https://www.cnblogs.com/LearningOnline/p/9221956.html