Django-DTL-filter与tag-自定义过滤器与标签

一、DTL简介

全称：Django模板语言(Django Template Language)
语法：
	filter {{ }}
	tag {% %}

二、简单变量的使用

在视图层中：
def dtl(request):
    num = 3.14
    ss = 'abc123嘿嘿'
    result = True
    list = [1,2,3,4,5]
    dic = {'name':'owen','age':28}
    def fn():
        return "fn function"
    class Person:
        name = 'name'
        def __str__(self):
            return '这是Person类'
    p = Person()
    return render(request, 'django_dtl.html',locals())

django_dtl.html:
<li>{{ num }}</li>
<li>{{ list }} -- {{ list.0 }}</li>
<li>{{ dic }} -- {{ dic.age }}</li>
<li>{{ Person }}</li>  # Person() => __str__的返回值
<li>{{ 123 }}</li>  # 也可以直接写数字、字符串、布尔值

三、过滤器

1.语法：
	-- {{ 变量|过滤器1[[:参数]|...|过滤器n[:参数]] }}
	-- 注：过滤器可以串联操作，可以拥有0个或1个参数
    
2.常见内置filter
	-- 增加  add:num
	-- 字符串长度  length
	-- 默认值  default:'默认值'  # 变量不存在或为空
	-- 全大写	upper
	-- 全小写	lower
	-- 切片	slice:'0:-1'
	-- 将数字转换为文件大小	filesizeformat
	-- 字符串隐藏	truncatechars:13   # 只显示10个字符，后置字符都用...来替代
	-- 时间	date:'Y-m-d'
	-- 转换原意  safe

四、标签

1.语法：
	-- {% 关键词 arg1 ... argn %}  eg: {% url 'test' 1 2 3 %} => /test/1/2/3/

2.常用：
	-- 反向解析url	{% url 'namespace:url_name' arg1 arg2 %}
	-- 当前时间now	{% now 'Y-m-d' %}
	-- 起别名with	{% with '后面的别名flag就代表我' as flag %} {{ flag }} {% endwith %}
	-- Django CSRF认证   {% csrf_token %}

四、分支

语法：
{% if 条件1 %}
    结论1
{% elif 条件2 %}
	结论2
{% else %}
    结论n
{% endif %}

注：
1. if的条件可以添加filter
2. 可以嵌套

五、迭代器

{% for foo in iterate %}
    {{ forloop }}
{% empty %}
    可迭代对象为
注:
1.iterate为可迭代对象
2.iterate可以添加filter
3.forloop变量为存放迭代信息的字典，父级forloop字典，开始索引从0编号或1编号，倒序索引从0编号或1编号，是否是第一次或最后一次循环
4.empty分支会在可迭代对象不存在或为空时执行

六、自定义过滤器与标签

步骤:
1.在注册的app下创建templatetags包
2.在模板中自定义模块py文件，如：owen_tags.py
3.要在使用自定义filter与tag的模板页面中加载自定义模块py文件，案例：{% load owen_tags %}
4.自定义filter语法
from django.template import Library
register = Library()
@register.filter(name='jump')
def owen_jump(value, arg):
	try:
        return value * int(arg)
    except (ValueError, TypeError):
        return ''
    
5.自定义tag语法
@register.simple_tag(name='add_two')
def owen_add(arg1, arg2):
	try:
        return int(arg1) + int(arg2)
    except (ValueError, TypeError):
        try:
            return arg1 + arg2
        except Exception:
            return ''

6.在加载了自定义模板py文件的模板页面中使用，案例：
{{ 10|jump:2}}  # 10 * 2
{% add_two 10 20 %}  # 10 + 20