欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

在Django框架中自定义模板过滤器的方法

程序员文章站 2024-01-10 14:41:40
自定义过滤器就是有一个或两个参数的python函数:     (输入)变量的值     参数的值...

自定义过滤器就是有一个或两个参数的python函数:

  •     (输入)变量的值
  •     参数的值, 可以是默认值或者完全留空

例如,在过滤器 {{ var|foo:"bar" }} 中 ,过滤器 foo 会被传入变量 var 和默认参数 bar。

过滤器函数应该总有返回值。 而且不能触发异常,它们都应该静静地失败。 如果出现错误,应该返回一个原始输入或者空字符串,这会更有意义。

这里是一些定义过滤器的例子:

def cut(value, arg):
  "removes all values of arg from the given string"
  return value.replace(arg, '')

下面是一个可以用来去掉变量值空格的过滤器例子:

{{ somevariable|cut:" " }}

大多数过滤器并不需要参数。 下面的例子把参数从你的函数中拿掉了:

def lower(value): # only one argument.
  "converts a string into all lowercase"
  return value.lower()

当你定义完过滤器后,你需要用 library 实例来注册它,这样就能通过django的模板语言来使用了:

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

library.filter() 方法需要两个参数:

  •     过滤器的名称(一个字串)
  •     过滤器函数本身

如果你使用的是python 2.4或者更新的版本,你可以使用装饰器register.filter():

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

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

如果你想第二个例子那样不使用 name 参数,那么django会把函数名当作过滤器的名字。

下面是一个完整的模板库的例子,它包含一个 cut 过滤器:

from django import template

register = template.library()

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

相关标签: Django 过滤器