Web框架之Django_04 模板层了解（过滤器、标签、自定义过滤器、标签、inclusion_tag、模板的继承与导入）

时间  2019-12-04
标签 web 框架 django 模板 了解 过滤器 标签 自定义 inclusion tag 继承 导入 栏目 HTML 繁體版
原文   原文链接

摘要：

模版层（模板语法）

  • 模板语法

  • 过滤器

  • 标签

  • 自定义过滤器、标签

  • inclusion_tag

  • 模板的继承

  • 模板的导入

1、模板语法：

  1. 经常使用语法：
    {{     }}    变量相关
    {% %}    逻辑相关
  2. 变量：
    在Django中的模板语言用{{ 变量名 }}来使用变量，而这个变量的来源一般是在视图函数里面产生的，经过render方法返回到前端，前端经过此语法来使用该变量。
    后端向前端页面传递数据的方式：
    # 第一种：
return render(request,'index.html',{'n':n})
# 第二种：
return render(request,'index.html',locals())  
# 将当前所在的名称空间中的名字所有传递给前端页面

    后端的传递的数据类型能够是：int、str、list、dict、tuple、set、function....
    传递的变量命名规则：包括任何字母数字以及下划线 ("_")的组合， 变量名称中不能有空格或标点符号。
    模板语法规定：使用句点符（就是点号：.)来取出变量中的相关数据，好比字典、列表、元祖、属性方法（对象）
    这里还须要强调一点：模板语法是不支持传参的。
    模板中支持的写法：css

    后端：views.py
l = [1,2,3,4,5,user_obj]
user_obj = models.Book.object.filter(id=1).first()
d = {'name': 'sgt', 'password': '123'}

前端：使用模板语法，来处理后端传递过来的变量

{# 取l中的第一个参数 #}
{{ l.0 }}
{# 取字典d中相应的值 #}
{{ d.name }}
{{ d.keys }}
{{ d.values }}
{{ d.items }}

{# 取对象的name属性 #}
{{ user_obj.name }}

{# .操做只能调用不带参数的方法 #}
{{ l.5.name }}

{% with l.5.name  as h %}
{{ h }}
{% endwith %}
{# 将 l.5.name找到的数据起名为h，这样就能够经过h这个名字获得 l.5.name的值 #}

    这里特别来讲说把
    函数：html

    后端：
def func():
        return '你调用了我？'

前端：
{{ func }}

显示结果：你调用了我？

在前端调用后端的函数名（固然此函数名确定在locals()里面）时，会调用该函数（函数名加括号），获得函数调用的返回值，若是无返回值则为None

    类：前端

        后端

        class Demo(object):
        def __init__(self, name):
            self.name = name
            
        def func(self):
            return self.name
        
        @classmethod
        def test(cls):
            return 'cls'
        
        @staticmethod
        def foo(name,age):
            return 'static_foo'
        
    obj = Demo('sgt')
    <app01.views.ttt.<locals>.Demo object at 0x0000024052F39898>
cls
sgt
sgt

    若是类里面加入：django

            def __str__(self):
            return 'Sgt帅得一塌糊涂！'

    那么{{ obj }}的结果就会变成：Sgt帅得一塌糊涂！（由于__str__会拦截打印动做，在前端{{ obj }}实际上就是相似于打印obj.后端

 2、过滤器：（Filters）

  1. 经常使用过滤器介绍：
    在Django的模板语言中，经过使用 过滤器 来改变变量的显示。安全

    过滤器的语法： {{ value|filter_name:参数 }}app

    使用管道符"|"来应用过滤器。
    这里的过滤的意思实际上我的认为概念很模糊，过滤器的意思是将变量经过使用后端的方法将变量进行相关操做加工逻辑处理的封装以后拿到前端去使用的一种过程实现。
    例如：{{ name|lower }}会将name变量应用lower过滤器以后再显示它的值。lower在这里的做用是将文本全都变成小写。
    注意事项：
    ##过滤器支持链式操做，即一个过滤器的输出结果做为另外一个过滤器的输入
    ##过滤器能够接收参数，例如：{{ sss|truncatewords:30 }}，这将显示sss的前30个词。
    ##过滤器参数包含空格的话，必须用引号包裹起来，好比使用逗号和空格去链接一个列表中的元素，如：{{ list|join:', ' }}
    ##管道符‘|’左右没有空格。必定要注意，没有空格
    Django的模板语言中提供了大约六十个内置过滤器。这里主要拿出一些常见的方法来介绍：
    #default
    若是一个变量是false或空，使用给定的默认值，不然使用该变量的值。    ide

    {{ value|default:"nothing"}}
若是value没有传值或者值为空的话就显示nothing

    #length
    返回值的长度，做用于字符串和列表    函数

    {{ value|length }}

后端：
s = 'what f**k!'
l = ['a', 'b', 4, 5, 8]

前端：
{{ l|length }}
{{ s|length }}

显示结果：5 10

    #filesizeformat
    将值格式化为一个可理解的文件大小单位（13kb，4m）oop

    {{ value|filesizeformat }}

后端：
n = 102478450

前端：
{{ n|filesizeformat }}

显示结果：97.7 MB

    #slice 切片（顾头不顾尾）

    {{value|slice:"开始索引:结束索引：步长"}}

后端：
s = 'what f**k!'
l = ['a', 'b', 4, 5, 8]

前端：
{{ l|slice:'1:4' }} 
{{ s|slice:'5:9' }}
{{ l|slice:'2:-1' }}    <!--从索引2开始切，切到索引为-1的位置为结尾，同时顾头不顾尾-->

显示结果：
['b', 4, 5] 
    f**k 
    [4, 5]

    #date 时间格式化输出

    {{ value|date:"Y-m-d H:i:s"}}

后端：
import datetime
ctime = datetime.datetime.now()

前端：
{{ ctime }}
{{ ctime|date:'Y-m-d H:i:s' }}

显示结果：
June 11, 2019, 2:51 p.m. 
2019-06-11 14:51:24
    a 'a.m.' 或 'p.m.' (注意,它与PHP 的输出略有不一样.它包括了句点(django扩展). 'a.m.' 
A 'AM' 或 'PM'. 'AM' 
B 未实现.   
d 每个月第几天, 带前导零 '01' to '31' 
D 每周第几天,3字母的字符串. 'Fri' 
f 时间, 12-小时制的小时和分钟数, 若是分钟数为零,则不显示.(django 扩展). '1', '1:30' 
F 月份, 长文本格式. 'January' 
g 小时, 12-小时制,没有前导零 '1' to '12' 
G 小时, 24-小时制,没有前导零 '0' to '23' 
h 小时, 12-小时制,有前导零 '01' to '12' 
H 小时, 24-小时制,有前导零 '00' to '23' 
i 分钟. '00' to '59' 
I 未实现   
j 每个月第几天, 无前导零 '1' to '31' 
l 每周第几天,长文本格式. 'Friday' 
L 是否闰年. True or False 
m 数字表示的月份,有前导零. '01' to '12' 
M 月份,3字母短文本格式. 'Jan' 
n 数字表示的月份,无前导零 '1' to '12' 
N 出版风格的月份缩写(django 扩展) 'Jan.', 'Feb.', 'March', 'May' 
O 与格林威治的时间差(以小时计) '+0200' 
P 12小时制的小时分钟及'a.m.'/'p.m.' 分钟数若为零则不显示. 用字符串表示特殊 的时间点, 如 'midnight' 和 'noon' (django扩展) '1 a.m.', '1:30 p.m.', 'midnight','noon', '12:30 p.m.' 
r RFC 822 格式的日期 . 'Thu, 21 Dec 2000 16:01:07+0200' 
s 秒数, 带有前导零的数字表示 '00' to '59' 
S 英语序数后缀,用于一个月的第几天,2个字符 'st', 'nd', 'rd' or 'th' 
t 给定月共有多少天. 28 to 31 
T 本机时区. 'EST', 'MDT' 
U 未实现   
w 一周中的第几天,没有前导零的数字 '0' (Sunday) to '6' (Saturday) 
W ISO-8601 一年的第多少星期数, 一周从 星期一开始 1, 23 
y Year, 2 位数字表示 '99' 
Y Year, 4 位数字表示 '1999' 
z 一年中的第几天 . 0 to 365 
Z 以秒计的时区偏移量. 这个偏移量对UTC西部 时区老是负数,而对UTC东部时区则老是正数 -43200 to 43200
    日期格式化参数

    #safe

    Django的模板中会对HTML标签和JS等语法标签进行自动转义，缘由显而易见，这样是为了安全。可是有的时候咱们可能不但愿这些HTML元素被转义，好比咱们作一个内容管理系统，后台添加的文章中是通过修饰的，这些修饰多是经过一个相似于FCKeditor编辑加注了HTML修饰符的文本，若是自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式，若是是一个单独的变量咱们能够经过过滤器“|safe”的方式告诉Django这段代码是安全的没必要转义。

    后端：
value = "<a href='https://www.cnblogs.com/suguangti/'>点我</a>"

前端：
{{ value }}
{{ value|safe }}

结果：
<a href='https://www.cnblogs.com/suguangti/'>点我</a> 
点我

下面那个‘点我’在页面上是一个a标签，点击可跳转

    上面的safe是在前端取消转义，后端取消转义方法以下：

    from django.utils.safestring import mark_safe
xxx = mark_safe('<h1>我是h1标签</h1>')

    #truncatechars
    若是字符串字符多于指定的字符数量，那么会被截断，截断的剩余字符将用省略号结尾表示。
    参数：截断的字符数（包含三个点）

    后端：
ss = 'abcdefghijklmnopqrstuvwxyz'

前端：
{{ ss|truncatechars:10 }}

结果：（注意...也算进长度里了）
abcdefg...

    #truncatewords
    以一个单词为一个元素，单词与单词之间的空格为区分依据，将必定数量的单词进行截断，截断后面的用...表示
    一个单词加上一个空格  计数一个

    后端：
sss = "Life was like a box of chocolates you never know what you're gonna get."

前端：
{{ sss|truncatewords:7 }}

显示结果：
Life was like a box of chocolates ...
    （注意chocolates后面有个空格）

     #cut

    移除变量中全部的指定相同的字符串

    {{ value|cut:' ' }}

后端：
ssss = 'you do bb now,bb is not good thing, why do you bb for too many times!'

前端：
{{ ssss|cut:'bb' }}

显示结果：
you do now, is not good thing, why do you for too many times!

    #join
    将列表中的元素用指定字符链接起来

    后端
ll = [1, 2, 3, 4, 5]

前端
{{ ll|join:'@' }}

结果
1@2@3@4@5
  2. 标签介绍：
    #for循环（内部有个empty判断，详见下面if判断示例） 
    后端
ll = [1, 2, 3, 4, 5]

前端
{% for foo in ll %}
     <p>{{ foo }}</p>
{% endfor %}

结果显示：
1
2
3
4
5

    forloop的使用：

    后端
ll = [1, 2, 3, 4, 5]

前端
{% for foo in ll %}
     <p>{{ forloop }}</p>
{% endfor %}

    forlop里面有几个属性须要咱们注意，好比 counter0，counter，first，last它们对应的值在for循环过程当中的开始和结束是不同的
    #if 判断

    {% for foo in l %}
if else
    {% if flag %}
        <p>flag不为空</p>
        {% else %}
        <p>flag是空</p>
    {% endif %}
    
{#(l = ['a', 'b', 'c', 'd', 'e'])#}
{% for foo in l %}
    {% if forloop.first %}
        <p>这是个人第一次</p>
    {% elif forloop.last %}
        <p>这是最后一次了啊</p>
    {% else %}
        <p>嗨起来！！！</p>
    {% endif %}
    {% empty %}   <!--若是l = []，上面的for循环不会进行，只会走这一步-->
        <p>你给个人容器类型是个空啊，无法for循环</p>
{% endfor %}
    l = ['a', 'b', 'c', 'd', 'e']
这是个人第一次
嗨起来！！！
嗨起来！！！
嗨起来！！！
这是最后一次了啊

l = []
你给个人容器类型是个空啊，无法for循环

  3. 自定义过滤器/标签/inclusion_tag：

    必须作的三件事
    1.在应用名下新建一个名为templatetags文件夹(必须叫这个名字)
    2.在该新建的文件夹内新建一个任意名称的py文件
    3.在该py文件中须要固定写下面两句代码
    ①这里在app01项目程序文件夹新建templatetags文件夹，在此文件夹内新建一个mine.py文件，打开mine.py文件>>输入：

    from django import template
register = template.Library()

# 自定义过滤器
@register.filter(name='my_filter')
def index(a, b):
    return a*b

# 自定义标签：
@register.simple_tag
def plus(a, b, c):
    return a+b+c

    ②前端html文件内使用过滤器或者标签：

    {% load mine %}   <!-- 要使用自定义过滤器和标签，须要先加载本身定义的文件 -->
{{ 9|my_filter:11 }}  <!-- 使用自定义过滤器，注意这里须要用name的值做为使用方法 -->
{% my_tag 1 2 3 %}  <!-- 使用自定义标签，注意这里须要用name的值做为使用方法 -->

    显示的结果：

    99
6

     自定义inclusion_tag

     inclusion_tag的做用：建立一个动态的html页面文件a.html，这个页面文件a能够在另一个页面b中被调用，实现这个页面a应该有的功能。好比：
    在上面的mine.py文件中建立inclusion_tag：

    # mine.py文件  建立inclusion_tag

from app01 import models 
from django import template
register = template.Library()

@register.inclusion_tag('inclusion_t_test.html', name='my_inclusion')
def func():
    book_list = models.Book.objects.all()
    return {'list': book_list} 

#将book_list的QuerySet对象列表传进inclusion_t_test.html文件

    inclusion_t_test.html文件里面：

    <!-- inclusion_t_test.html文件，被导入的html文件-->
<table>
    <thead>
        <tr>
            <th>id</th>
            <th>title</th>
            <th>price</th>
        </tr>
    </thead>
    <tbody>
        {% for obj in list %}
            <tr>
                <td>{{ obj.id }}</td>
                <td>{{ obj.title }}</td>
                <td>{{ obj.price }}</td>
            </tr>
        {% endfor %}
    </tbody>
</table>

    调用的html页面文件：

    {% load mine %}    <!-- 必需要先加载建立标签的文件-->
{% my_inclusion %}  <!-- 调用inclusion_t_test.html页面文件，这里使用该标签的name来调用-->

3、模板的继承与模板的导入

  • 模板的继承：
    继承的概念咱们都知道：在类里面是直接可使用基类中的属性和方法，也就是直接能用，不须要本身再写的意义。
    而模板的继承：咱们须要使用一个网页中一些固定不变的部分，再不用再本身写或者复制的前提下，只须要写几段代码就能拿来在一个新的网页使用，就像一个模板，模板中变化的地方咱们本身指定，其余地方不变，值只变化咱们指定的地方。
    实现过程：
    首先须要在被继承的模板中划分多个区域，这些区域是咱们能的可变更区 
    {% block 给区域起的名字 %}

{% endblock %}

<!--一般状况下一个模板中应该至少有三块-->
{% block css %}
  页面css代码块
{% endblock %}

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

{% block content %}
  页面主体内容
{% 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 %}

    若是在一个block模板中须要保留原始的内容则能够在这个block中任意你想要的位置添加一个{{ block.super }}，就能够保留原内容
  • 模板的导入
    将一段html当作模块的方式导入到另外一个html展现     
    {% include '想导入的html文件名' %}

    模板导入与自定义inclusion_tag的区别：模板导入的页面内容是静态的、不变的，而经过自定义inclusion_tag导入的页面文件能够是动态的，可动性本身掌控。

    补充：静态文件配置

    {% load static %}  
    
    <link rel='stylesheet' href="{% static 'css/mycss.css'%}">  # 第一种方式
    <link rel='stylesheet' href="{% get_static_prefix %}css/mycss.css">  # 第二种方式
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程