自定義過(guò)濾器只是常規(guī)的 Python 函數(shù)，過(guò)濾器左邊作為第一個(gè)參數(shù)，其余的參數(shù)作 為額外的參數(shù)或關(guān)鍵字參數(shù)傳遞到過(guò)濾器。

例如在過(guò)濾器?{{?42|myfilter(23)?}}?中，函數(shù)被以?myfilter(42,?23)?調(diào) 用。這里給出一個(gè)簡(jiǎn)單的過(guò)濾器示例，可以應(yīng)用到 datetime 對(duì)象來(lái)格式化它們:

def datetimeformat(value, format='%H:%M / %d-%m-%Y'):
    return value.strftime(format)

你可以更新環(huán)境上的?filters?字典來(lái)把它注冊(cè)到模板環(huán)境上:

environment.filters['datetimeformat'] = datetimeformat

在模板中使用如下:

written on: {{ article.pub_date|datetimeformat }}
publication date: {{ article.pub_date|datetimeformat('%d-%m-%Y') }}

也可以傳給過(guò)濾器當(dāng)前模板上下文或環(huán)境。當(dāng)過(guò)濾器要返回一個(gè)未定義值或檢查當(dāng)前的autoescape?設(shè)置時(shí)很有用。為此，有三個(gè)裝飾器：?environmentfilter()?、?contextfilter()和?evalcontextfilter()?。

這里是一個(gè)小例子，過(guò)濾器把一個(gè)文本在 HTML 中換行或分段，并標(biāo)記返回值為安全 的 HTML 字符串，因?yàn)樽詣?dòng)轉(zhuǎn)義是啟用的:

import re
from jinja2 import evalcontextfilter, Markup, escape

_paragraph_re = re.compile(r'(?:\r\n|\r|\n){2,}')

@evalcontextfilter
def nl2br(eval_ctx, value):
    result = u'\n\n'.join(u'<p>%s</p>' % p.replace('\n', '<br>\n')
                          for p in _paragraph_re.split(escape(value)))
    if eval_ctx.autoescape:
        result = Markup(result)
    return result

上下文過(guò)濾器工作方式相同，只是第一個(gè)參數(shù)是當(dāng)前活動(dòng)的?Context?而 不是環(huán)境。