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 %}