Django模板之自定义过滤器/标签/组件

自定义步骤：

1. 在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.

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

3. 创建任意 .py 文件，如：my_tags.py

· 导入模块：from django import template

· 实例化注册器：register = template.Library() #register的名字是固定的,不可改变

4. 在自定义模块（my_tags.py）中定义不同的函数，使用不同注册类进行装饰

· 注册过滤器：@register.filter

自定义过滤器函数的参数最多不能超过两个，第一个参数默认为渲染的变量

· 注册标签：@register.simple_tag

自定义标签函数的参数个数不限

· 注册组件：@register.inclusion_tag("渲染模板.html")

自定义组件标签函数的返回值作为注册器渲染的数据，然后将渲染后的模板返回给调用页面（类似组件）

　　　　　5. 在使用自定义过滤器、标签、标签组件时，必须现在html文档首行导入自定义的模块：{% load my_tags %}　　　

自定义过滤器演示：

app应用中的templatetags包中my_tags.py模块：

 from django import template

 register=template.Library()     #register变量名是固定不变的

 @register.filter

 def sum_filter(a,b):    #参数最多不超过两个，第一个默认为模板变量

     '''

     模板变量过滤器，返回值作为渲染结果

     :param a: 模板变量

     :param b: 给定参数

     :return: 渲染显示数据

     '''

     return a+b

　　my_filters.html

 {% load my_tags %}

 <!DOCTYPE html>

 <html lang="en">

 <head>

     <meta charset="UTF-8">

     <meta http-equiv="refresh" content="">

     <meta name="keywords" content="">

     <style></style>

     <script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.js"></script>

     <link rel="stylesheet" href="">

     <title>自定义过滤器</title>

 </head>

 <body>

     <div>

         <h1>{{ num|sum_filter:10 }}</h1>

     </div>

 </body>

 </html>

　　views.py

 def my_filters(request):

     n=10

     return render(request,"my_filters.html",{"num":n})

　　渲染结果：

自定义标签演示：

app应用中的templatetags包中模块：

 from django import template

 register=template.Library()     #register变量名是固定不变的

 @register.simple_tag

 def sum_simple_tag(a,b,c):         #自定义标签参数不限

     return a+b+c

　　my_tags.html

 {% load my_tags %}

 <!DOCTYPE html>

 <html lang="en">

 <head>

     <meta charset="UTF-8">

     <title>自定义标签演示</title>

 </head>

 <body>

     <div><h1>{{ num }} </h1></div>

     <div><h1>{% sum_simple_tag 2 4 5 %}</h1></div>

     <div><h1>{% sum_simple_tag num 4 5 %}</h1></div>

 </body>

 </html>

　　views.py

 def my_tag(request):

     n=10

     return render(request,"my_tags.html",{"num":n})

　　渲染结果：

自定义组件标签演示：

app应用中的templatetags包中模块：

 from django import template

 register=template.Library()     #register变量名是固定不变的

 @register.inclusion_tag("inclusion.html")#组件注册标签类必须参入一个组件模板的html文件接收函数返回值进行渲染

 def sum_inclusion_tag(m,n):

     '''

     自定义组件标签，函数返回值给注册类模板参数渲染，渲染之后的html文件当成组件自动在标签调用页面渲染显示

     :param m: 给定的组件标签参数

     :param n:给定的组件标签参数

     :return: 自定形式的值当场注册类参数模板的模板变量进行渲染

     '''

     li=[]

     for i in range(m,n):

         li.append(i)

     return {"list":li}

　　inclusion.html

 <!DOCTYPE html>

 <html lang="en">

 <head>

     <meta charset="UTF-8">

     <title>注册标签组件</title>

 </head>

 <body>

     <ul>

         {% for i in list %}

             <li>{{ i }}</li>

         {% endfor %}

     </ul>

 </body>

 </html>

　　my_inclusion_tag.html

 {% load my_tags %}

 <!DOCTYPE html>

 <html lang="en">

 <head>

     <meta charset="UTF-8">

     <title>自定义组件标签演示</title>

 </head>

 <body>

     <div>

         {% sum_inclusion_tag 10 20 %}

     </div>

 </body>

 </html>

　　views.py

def my_inclusion_tag(request):

    return render(request,"my_inclusion_tag.html")

　　渲染结果：

其他相关（mark_safe) ：

#mark_safe渲染的数据可以被识别成html标签内容

 from django import template

 from django.utils.safestring import mark_safe

 register = template.Library()   #register的名字是固定的,不可改变

 @register.simple_tag

 def my_input(id,arg):

     result = "<input type='text' id='%s' class='%s' />" %(id,arg,)

     return mark_safe(result)