模板层

06 模板层

一. 模版语法

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

1. 注释是代码的规范

{# ... #}

2. 基本数据类型传值

int1 = 123
float1 = 11.11
str1 = '我也想奔现'
bool1 = True
list1 = ['小红', '姗姗', '花花', '茹茹']
tuple1 = (111, 222, 333, 444)
dict1 = {'username': 'jason', 'age': 18, 'info': '这个人有点意思'}
set1 = {'晶晶', '洋洋', '嘤嘤'}

# 基本数据类型都支持
{{ int1 }}
{{ float1 }}
{{ str1 }}
{{ bool1 }}
{{ list1 }}
{{ tuple1 }}
{{ dict1 }}
{{ set1 }}

3. 函数和类传值

def func():
    print('我被执行了')
    return '你的另一半在等你'

class MyClass(object):
    def get_self(self):
        return 'self'

    @staticmethod
    def get_func():
        return 'func'

    @classmethod
    def get_class(cls):
        return 'cls'
    
    # 对象被展示到html页面上 就类似于执行了打印操作也会触发__str__方法
    def __str__(self):
        return  'cls'

obj = MyClass()


# 传递函数名会自动加括号调用 但是模版语法不支持给函数传额外的参数
{{ func }}

# 传类名的时候也会自动加括号调用(实例化)
{{ MyClass }}

# 内部能够自动判断出当前的变量名是否可以加括号调用 如果可以就会自动执行  针对的是函数名和类名
{{ obj }}
{{ obj.get_self }}
{{ obj.get_func }}
{{ obj.get_class }}


# 总结
'''
1. 如果计算结果的值是可调用的，它将被无参数的调用。 调用的结果将成为模版的值。
2. 如果使用的变量不存在， 它被默认设置为'' (空字符串) 。
'''

4. 模版语法的取值

django模版语法的取值 是固定的格式 只能采用“句点符”.

{{ dict1.username }}
{{ list1.0 }}</p>
{{ dict1.hobby3.info }}

5. 模板语法的优先级

点.在模板语言中有特殊的含义。当模版系统遇到点.，它将以这样的顺序查询：

'''
1. 字典查询（Dictionary lookup）
2. 属性或方法查询（Attribute or method lookup）
3. 数字索引查询（Numeric index lookup）
'''

二. Filters过滤器(注意: 过滤器只能最多有两个参数)

过滤器就类似于是模版语法内置的 内置方法.

django内置有60多个过滤器我们这里了解一部分即可

过滤器语法: {{数据|过滤器:可选参数}}

注意事项:

1. 过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
2. 过滤器可以接受参数，例如：{{ sss|truncatewords:30 }}，这将显示sss的前30个词。
3. 过滤器参数包含空格的话，必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素，如：{{ list|join:', ' }}
4. '|'左右没有空格没有空格没有空格

Django的模板语言中提供了大约六十个内置过滤器我们这里介绍14种:

# 统计长度: 作用于字符串和列表。
    {{ str1|length }}
    
    
# 默认值: 第一个参数布尔值是True就展示第一个参数的值否则就展示冒号后面的值
    {{ bool1|default:'谁的布尔值为True谁就展示' }}
    
    
# 文件大小:
    {{ file_size|filesizeformat }}  # 9.8 KB 
    
    
# 日期格式化:  将值格式化为一个 “人类可读的” 文件尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等
    {{ current_time|date }}         # May 29, 2020
    {{ current_time|date:'Y-m-d' }}      # 2020-05-29
    {{ current_time|date:'Y-m-d H:i:s' }}    # 2020-05-29 01:31:09
    
    
# 切片操作: 支持步长
    {{ list1|slice:'0:4:2' }}
    
    
# 切取字符: 如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾 (注意: 包含这三个点)
    {{ info|truncatechars:9 }}   
    
    
# 切取单词: 不包含三个点 按照空格切取, 不是识别单词语法
    {{ msg|truncatewords:3 }}    
    
    
# 移除特定的字符:
    {{ msg|cut:' '}}    
    

# 拼接操作: 
    # join
        {{ info|join:'$' }}
    # 加法: 数字就相加  字符就拼接
        {{ int1|add:float1 }}
        {{ str1|add:str1 }} 
    
    
# 转义!!!!:
    # 后端的转义
    from django.utils.safestring import mark_safe
    html_safe = mark_safe('<h1>哈哈哈</h1>')

    {{ html }}           # 普通的标签使用模板, 任然是模板
    {{ html_safe }}      # 后端的转义传值
    {{ html|safe }}      # 前端的转义    

date参数介绍:

格式化字符	描述	示例输出
a	'a.m.'或'p.m.'（请注意，这与PHP的输出略有不同，因为这包括符合Associated Press风格的期间）	'a.m.'
A	'AM'或'PM'。	'AM'
b	月，文字，3个字母，小写。	'jan'
B	未实现。
c	ISO 8601格式。 （注意：与其他格式化程序不同，例如“Z”，“O”或“r”，如果值为naive datetime，则“c”格式化程序不会添加时区偏移量（请参阅datetime.tzinfo） 。	2008-01-02T10:30:00.000123+02:00或2008-01-02T10:30:00.000123如果datetime是天真的
d	月的日子，带前导零的2位数字。	'01'到'31'
D	一周中的文字，3个字母。	“星期五”
e	时区名称 可能是任何格式，或者可能返回一个空字符串，具体取决于datetime。	''、'GMT'、'-500'、'US/Eastern'等
E	月份，特定地区的替代表示通常用于长日期表示。	'listopada'（对于波兰语区域，而不是'Listopad'）
f	时间，在12小时的小时和分钟内，如果它们为零，则分钟停留。 专有扩展。	'1'，'1:30'
F	月，文，长。	'一月'
g	小时，12小时格式，无前导零。	'1'到'12'
G	小时，24小时格式，无前导零。	'0'到'23'
h	小时，12小时格式。	'01'到'12'
H	小时，24小时格式。	'00'到'23'
i	分钟。	'00'到'59'
I	夏令时间，无论是否生效。	'1'或'0'
j	没有前导零的月份的日子。	'1'到'31'
l	星期几，文字长。	'星期五'
L	布尔值是否是一个闰年。	True或False
m	月，2位数字带前导零。	'01'到'12'
M	月，文字，3个字母。	“扬”
n	月无前导零。	'1'到'12'
N	美联社风格的月份缩写。 专有扩展。	'Jan.'，'Feb.'，'March'，'May'
o	ISO-8601周编号，对应于使用闰年的ISO-8601周数（W）。 对于更常见的年份格式，请参见Y。	'1999年'
O	与格林威治时间的差异在几小时内。	'+0200'
P	时间为12小时，分钟和'a.m。'/'p.m。'，如果为零，分钟停留，特殊情况下的字符串“午夜”和“中午”。 专有扩展。	'1 am'，'1:30 pm' / t3>，'midnight'，'noon'，'12：30 pm' / T10>
r	RFC 5322格式化日期。	'Thu, 21 Dec 2000 16:01:07 +0200'
s	秒，带前导零的2位数字。	'00'到'59'
S	一个月的英文序数后缀，2个字符。	'st'，'nd'，'rd'或'th'
t	给定月份的天数。	28 to 31
T	本机的时区。	'EST'，'MDT'
u	微秒。	000000 to 999999
U	自Unix Epoch以来的二分之一（1970年1月1日00:00:00 UTC）。
w	星期几，数字无前导零。	'0'（星期日）至'6'（星期六）
W	ISO-8601周数，周数从星期一开始。	1，53
y	年份，2位数字。	'99'
Y	年，4位数。	'1999年'
z	一年中的日子	0到365
Z	时区偏移量，单位为秒。 UTC以西时区的偏移量总是为负数，对于UTC以东时，它们总是为正。	-43200到43200

三. 标签

1. for循环

forloop.first	第一次循环返回True, 其余返回False
forloop.last	最后一次循环返回False, 其余返回True
forloop.counter	当前循环次数. 从1开始
forloop.counter0	当前循环索引. 从0开始
forloop.revcounter	当前循环次数取反
forloop.revcounter0	当前循环索引取反
forloop.parentloop	本层循环的外层循环

展示格式:

{'parentloop': {}, 'counter0': 0, 'counter': 1, 'revcounter': 4, 'revcounter0': 3, 'first': True, 'last': False}
{'parentloop': {}, 'counter0': 1, 'counter': 2, 'revcounter': 3, 'revcounter0': 2, 'first': False, 'last': False}
{'parentloop': {}, 'counter0': 2, 'counter': 3, 'revcounter': 2, 'revcounter0': 1, 'first': False, 'last': False}
{'parentloop': {}, 'counter0': 3, 'counter': 4, 'revcounter': 1, 'revcounter0': 0, 'first': False, 'last': True}
{% for foo in list1 %}
    <p>{{ forloop }}</p>
    <p>{{ foo }}</p>  # 一个个元素
{% endfor %}

2. if判断

# if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断
{% if bool1 %}
    <p>1111</p>
{% elif int1 %}
    <p>2222</p>
{% else %}
    <p>3333</p>
{% endif %}

3. for与if混合使用

Copy{% for foo in list1 %}
    {% if forloop.first %}
        <p>这是我的第一次</p>
    {% elif forloop.last %}
        <p>这是最后一次啊</p>
    {% else %}
        <p>上面都不是才轮到我</p>
    {% endif %}

    {% empty %}
        <p>for循环的可迭代对象内部没有元素 根本没法循环</p>
{% endfor %}

4. 处理字典values,keys,items方法

{% for foo in dict1.values %}
    <p>{{foo}}</p>
{% endfor %}

{% for foo in dict1.keys %}
    <p>{{foo}}</p>
{% endfor %}

{% for foo in dict1.items %}
    <p>{{foo}}</p>
{% endfor %}

5. with起别名

在with语法内就可以通过as后面的别名快速的使用到前面非常复杂获取数据的方式

dict1 = {'username': 'egon', 'hobby': ['吃', '喝', '玩', {'info': '他喜欢吃生蚝!!!'}]}

# 书写方式一: as语句
{% with dict1.hobby.3.info as nb %}
    <p>{{ nb }}</p>
    {# 与上面等同, 但是长语句, 还是使用with赋值来进行 #}
    <p>{{ dict1.hobby.3.info }}</p>
{% endwith %}


# 书写方式二: 赋值
{% with nb=dict1.hobby.3.info %}
    <p>{{ nb }}</p>
    {# 与上面等同, 但是长语句, 还是使用with赋值来进行 #}
    <p>{{ dict1.hobby.3.info }}</p>
{% endwith %}

四. 自定义过滤器、标签、inclusion_tag

1. 准备步骤

1. 在应用下创建一个名字”必须“叫templatetags文件夹
2. 在该文件夹内创建“任意”名称的py文件
3. 在该py文件内"必须"先书写下面两句话(单词一个都不能错)
    from django import template
    register = template.Library()

2. 自定义过滤器

强调: 自定义过滤器函数, 最大只能设有2个形参

from .templatetags.mytag import register
@register.filter(name='my_sum')
def abc(v1, v2):  # abc函数名任意. 导入自定义过滤器使用的是上面指定的name的值
    return v1 + v2


# 使用: (注意: 先导入我们自定义filter那个文件mytag)
{% load mytag %}
<p>{{ int1|my_sum:100 }}</p>

3. 自定义标签

# 自定义标签: 数可以有多个 类似于自定义函数
from .templatetags.mytag import register
@register.simple_tag(name='my_join')
def abc(a, b, c, d):  # abc函数名任意. 导入自定义标签使用的是上面指定的name的值
    return f'{a}-{b}-{c}-{d}'

# 使用: 标签多个参数彼此之间空格隔开(注意: 先导入我们自定义filter那个文件mytag)
{% load mytag %}
p>{% my_join 'json' 123 123 123 %}</p>

4. 自定义inclusion_tag

'''
内部原理:
    先定义一个方法 
    在页面上调用该方法 并且可以传值
    该方法会生成一些数据然后传递给一个html页面
    之后将渲染好的结果放到调用的位置
'''
from .templatetags.mytag import register
@register.inclusion_tag('left_memu.html')  # 注意: 这里传的是渲染的HTML文件, 不需要指定关键字name
def left(n):
    data = ['第{}项'.format(i) for i in range(n)]
    # 第一种: 将data传递给left_menu.html
    # return {'data':data}

    # 第二种: 将data传递给left_menu.html
    return locals()


# left_memu.html
{% for foo in data %}
    {% if forloop.first %}
        <p>{{foo}}</p>
    {% elif forloop.last %}
        <p>{{ foo }}</p>
    {% endif %}
{% endfor %}


# index使用(注意: 先导入我们自定义filter那个文件mytag)
{% load mytag %}
{% left 5 %}

五. 模板的继承

# 模版的继承 你自己先选好一个你要想继承的模版页面
{% extends 'home.html' %}


# 继承了之后子页面跟模版页面长的是一模一样的 你需要在模版页面上提前划定可以被修改的区域
{% block content %}
	模版内容
{% endblock %}


# 子页面就可以声明想要修改哪块划定了的区域
{% block content %}
	子页面内容
{% endblock %}


# 一般情况下模版页面上应该至少有三块可以被修改的区域, 这样每一个子页面就都可以有自己独有的css代码 html代码 js代码
{% block css %}
    1.css区域
{% endblock %}

{% block content %}
    2.html区域
{% endblock %}

{% block js %}
    3.js区域
{% endblock %}


"""
一般情况下 模版的页面上划定的区域越多 那么该模版的扩展性就越高
但是如果太多 那还不如自己直接写
"""

六. 模版的导入

"""
将页面的某一个局部当成模块的形式
哪个地方需要就可以直接导入使用即可
"""
'''静态导入'''
{% include 'wasai.html' %}


'''动态导入'''
# 被导入的text.html
<p>{{ name }}</p>   {# 这里的name就是"egon"#}

# 导入html的文件
{% include 'text.html' with name='"egon"' %}
    
    
# 不过上面的导入的参数是写死的. 如果你想动态的通过模板语法传参, 你可以这样
{% include 'text.html' with name=username %}    {#注意哦! 这里的username是视图层传过来的哦!#}
# 被导入文件中如果想{{ name }}模板以后是字符串的格式你可以这也指定即可!
<p>'{{ name }}'</p>   {#注意: 如果不加引号, 这种字符串的格式的话, 那么name模板传值以后就是一个变量.#}

七. 总结

# 模板语法的母亲 -> 注释
    {# #}

# 模板语法2种书写语法
    # 变量相关: {{}}
    # 逻辑相关: {%%}

# 支持的数据类型:
    # 基本数据类型: int float bool str tuple list set dict
    # 函数和类: function, class
        注意:
        1. 默认调用拿到的是返回值.
        2. 无法传值. 如果需要传值的类型, 那么这个模板语法就不会生效.
        3. 类中定义__str__方法, {{obj}}会触发其执行.

# 模板语法的取值:
    固定格式. 句点符. 支持连点, 支持索引, 支持键.
    例子: {{ user.name.0.1.0.info }}


# 过滤器: 最多只能有2个参数
    # 语法: {{ 数据|过滤器:可选参数 }}
    # 过滤器介绍:
        |length               获取长度
        |default:默认值        指定默认值. 前面布尔值为False才展示后面指定的参数 内部使用return v1 or v2
        |filesizeformat       返回人性化文件大小格式KB MB....
        |date:'Y-m-d'         返回 年-月-日 时间格式
        |slice:'0:4:2'        切片 支持步长
        |truncatechars:9      截取字符 包含三点
        |truncatewords:9      截取单词 不包含三点 以空格区分
        |cut:' '              移除特定字符
        |join:'$'             拼接操作
        |add:99               数字就加  字符就拼接
        |safe                 前端 取消转义
        from django.util.safestring import mark_safe
        res = mark_safe('<h1>我是你爸爸</h1>')
        {{ res }}             后端 取消转义

# 标签
    # for循环
        {% for i in user_list %}
            {{ forloop }}
            forloop.first         循环到第一次  True
            forloop.last          循环到最后一次 False
            forloop.counter       当前循环次数
            forloop.counter0      当前循环索引
            forloop.revcounter    当前循环次数取反
            forloop.revcounter0   当前循环索引取反
        {% endfor %}

    # if判断
        {% if 条件 %}
            ...
        {% elif %}
            ...
        {% else %}
            ...
        {% endif %}

    # for与if混合使用
        {% for i in user_list %}
            {% if forloop.first %}
                ...
            {% if forloop.last %}
                ...
            {% endfor %}
            {% empty %}
                迭代对象为空时触发
        {% endfor %}

    # 处理字典的values, keys, items方法
    # with取别名
        {% with user.name.0.1.0.info as xxx %}
        {% with xxx=user.name.0.1.0.info %}
            {{ xxx }}
        {% endwith  %}


# 自定义过滤器
    # 三步骤:
        1. 先在需要使用过滤器的应用中创建templatetags文件夹
        2. 接着进入文件夹中创建任意名称的.py文件. -->  mytag.py
        3. 写入以下固定格式的内容:
            from django import template
            register = template.Library()

    # 自定义过滤器: 最多2个参数
        # 视图层定义
            from templatetags.mytag import register
             @register.filter(name='过滤器名称 -> my_sum')
             def 任意函数名(v1, v2):
                return v1 + v2
        # 模板层使用
            {% load mytag %}
            {{ v1|my_sum:v2 }}

    # 自定义标签: 任意参数
        # 视图层定义
            from templatetags.mytag import register
            @register.simple_tag(name='标签名称 -> my_join')
            def 任意函数名(a, b, c, d):
                return f'{a}-{b}-{c}-{d}'

        # 模板层使用
            {% load mytag %}
            {{ my_join 111 222 333 444 }}

    # 自定义inclusion_tag
        # 视图层定义
           from templatetags.mytag import register
            @register.inclusion_tag('需要传递数据的html文件 -> index.py')
            def left(n):
                data = [f'第{i}项' for i in range(n)]
                return locals()          # 传递数据方式1
                # return {"data": data}  # 传递数据方式2

        # index.py定义
            <ul>
            {% for item in data %}
                <li>{{ item }}</li>
            {% endfor %}
            </ul>

        # 模板层使用
            {% load mytag %}
            {% left 5 %}

# 模板的继承
    # 子页面声明需要继承的模板页面
        {% extends '模板页面名' %}

    # 需要被划分模板页面中的某块区域
        {% block context %}
            ...
        {% endblock %}

    # 子页面声明替换区域
        {% block context %}
            ...
        {% endblock %}

    # 一般一情况下子页面有3种独立的形式. 提示: 太多不如不继承
        js, css, html

# 模板的导入
    {% include '.html' %}