Python Django Library.filter用法及代码示例

本文介绍 django.template.Library.filter 的用法。

声明

django.template.Library.filter()

编写过滤器定义后，需要将其注册到 Library 实例中，以使其可用于 Django 的模板语言：

register.filter('cut', cut)
register.filter('lower', lower)

Library.filter() 方法有两个参数：

1. 过滤器的名称 - 一个字符串。
2. 编译函数 - Python 函数(不是字符串形式的函数名称)。

您可以使用 register.filter() 作为装饰器：

@register.filter(name='cut')
def cut(value, arg):
    return value.replace(arg, '')

@register.filter
def lower(value):
    return value.lower()

如果你不使用 name 参数，如上面的第二个示例，Django 将使用函数的名称作为过滤器名称。

最后，register.filter() 还接受三个关键字参数 is_safe 、 needs_autoescape 和 expects_localtime 。这些参数在下面的过滤器和auto-escaping 以及过滤器和时区中进行了说明。