代码布局:(自定义的代码放在哪?)
1、创建某个 app 特有的:
在 app 目录下,创建 templatetags python包(文件夹);
再到 templatetags 文件夹下创建python模块(文件)
注意:templatetags 这个名字固定的,里面的模块名是自定义的
2、创建复用(公用)的:
创建一个新的app,将他们定义在新的app中,在主目录的setting.py文件里的 INSTALL_APPS 注册,然后就可以应用
一、自定义模板过滤器
创建:
模板过滤器就是一个函数:
一般有一个或或两个参数
第一个参数,一般是传递进来的模板变量;
第二个参数,普通的参数,也可以十默认,也可以不要;
定义就是写一个函数
注册:
1、通过 django.template.Library 它的实例(一定要是:register)的 filter 方法
filter 有两个参数:
1)、name:过滤器的名称,是个字符串,可以不写,默认使用方法名作为过滤器的名称;
2)、filter_func: 定义的过滤器的函数(函数对象);注意不要把函数名写成字符串
register.filter('别名',自定义的函数名)
2、通过装饰器:
@register.filter #这里可以传入 @register.filter(name='newname') 取别名
使用:
需要使用{% load %}标签将我们的自定义模块加载进来
{% load %} 声明将会载入给定模块名中的标签/过滤器
二、自定义模板标签:
自定义简单标签:
创建:
就是一个普通的python函数
注册:
1、通过 django.template.Library 它的实例(一定要是:register)的 simple_tag 方法
simple_tag 有两个参数:
1)、name:过滤器的名称,是个字符串,可以不写,默认使用方法名作为过滤器的名称;
2)、filter_func: 定义的过滤器的函数,(函数对象)
register.simple_tag(name='别名',自定义的函数名)
2、通过装饰器:
@register.simple_tag #这里也可以传入 @register.simple_tag(name='newname') 取别名
使用:
需要使用{% load %}标签将我们的自定义模块加载进来
{% load %} 声明将会载入给定模块名中的标签/过滤器
引用上下文变量:(views 中render传递到模板中的那个 context)
只需要在 simple_tag 中设置 take_context=True
自定义标签函数的第一个参数一定是 context
包含标签:(inclusion tags)
通过渲染另一个模板来展示数据
定义:
定义一个函数,接收调用时传递的模板变量
定义一个模板,供这个函数使用
注册:
1、通过 django.template.Library 它的实例(一定要是:register)的 inclusion_tag 方法
inclusion_tag 有两个参数:
1)、name:过滤器的名称,是个字符串,可以不写,默认使用方法名作为过滤器的名称;
2)、filter_func: 定义的过滤器的函数,(函数对象)
register.inclusion_tag(自定义的函数名) #传入定义的那个供函数使用的模板
2、通过装饰器:
@register.inclusion_tag('自定义的那个模板文件')
使用:
需要使用{% load %}标签将我们的自定义模块加载进来
{% load %} 声明将会载入给定模块名中的标签/过滤器
引用上下文变量:(views 中render传递到模板中的那个 context)
只需要在 inclusion_tag 中设置 take_context=True
自定义标签函数的第一个参数一定是 context