過(guò)濾器
過(guò)濾器的本質(zhì)就是函數(shù)。有時(shí)候我們不僅僅只是需要輸出變量的值擂错,我們還需要修改變量的顯示峻仇,甚至格式化、運(yùn)算等等帽芽,而在模板中是不能直接調(diào)用 Python 中的某些方法,那么這就用到了過(guò)濾器翔冀。
使用方式:
- 過(guò)濾器的使用方式為:變量名 | 過(guò)濾器导街。
{{variable | filter_name(*args)}}
- 如果沒(méi)有任何參數(shù)傳給過(guò)濾器,則可以把括號(hào)省略掉
{{variable | filter_name}}
- 如:``,這個(gè)過(guò)濾器的作用:把變量variable 的值的首字母轉(zhuǎn)換為大寫纤子,其他字母轉(zhuǎn)換為小寫
鏈?zhǔn)秸{(diào)用
在 jinja2 中搬瑰,過(guò)濾器是可以支持鏈?zhǔn)秸{(diào)用的款票,示例如下:
{{ "hello world" | reverse | upper }}
常見(jiàn)內(nèi)建過(guò)濾器
字符串操作
- safe:禁用轉(zhuǎn)義
<p>{{ '<em>hello</em>' | safe }}</p>
- capitalize:把變量值的首字母轉(zhuǎn)成大寫,其余字母轉(zhuǎn)小寫
<p>{{ 'hello' | capitalize }}</p>
- lower:把值轉(zhuǎn)成小寫
<p>{{ 'HELLO' | lower }}</p>
- upper:把值轉(zhuǎn)成大寫
<p>{{ 'hello' | upper }}</p>
- title:把值中的每個(gè)單詞的首字母都轉(zhuǎn)成大寫
<p>{{ 'hello' | title }}</p>
- reverse:字符串反轉(zhuǎn)
<p>{{ 'olleh' | reverse }}</p>
- format:格式化輸出
<p>{{ '%s is %d' | format('name',17) }}</p>
- striptags:渲染之前把值中所有的HTML標(biāo)簽都刪掉
<p>{{ '<em>hello</em>' | striptags }}</p>
- truncate: 字符串截?cái)?/li>
<p>{{ 'hello every one' | truncate(9)}}</p>
列表操作
- first:取第一個(gè)元素
<p>{{ [1,2,3,4,5,6] | first }}</p>
- last:取最后一個(gè)元素
<p>{{ [1,2,3,4,5,6] | last }}</p>
- length:獲取列表長(zhǎng)度
<p>{{ [1,2,3,4,5,6] | length }}</p>
- sum:列表求和
<p>{{ [1,2,3,4,5,6] | sum }}</p>
- sort:列表排序
<p>{{ [6,2,3,1,5,4] | sort }}</p>
語(yǔ)句塊過(guò)濾
{% filter upper %}
一大堆文字
{% endfilter %}
自定義過(guò)濾器
過(guò)濾器的本質(zhì)是函數(shù)泽论。當(dāng)模板內(nèi)置的過(guò)濾器不能滿足需求艾少,可以自定義過(guò)濾器。自定義過(guò)濾器有兩種實(shí)現(xiàn)方式:
- 一種是通過(guò)Flask應(yīng)用對(duì)象的 add_template_filter 方法
- 通過(guò)裝飾器來(lái)實(shí)現(xiàn)自定義過(guò)濾器
重要:自定義的過(guò)濾器名稱如果和內(nèi)置的過(guò)濾器重名翼悴,會(huì)覆蓋內(nèi)置的過(guò)濾器缚够。
方式一
通過(guò)調(diào)用應(yīng)用程序?qū)嵗腶dd_template_filter方法實(shí)現(xiàn)自定義過(guò)濾器。該方法第一個(gè)參數(shù)是函數(shù)名鹦赎,第二個(gè)參數(shù)是自定義的過(guò)濾器名稱:
def do_filterdoublesort(ls):
return ls[::2]
app.add_template_filter(do_filterdoublesort,'db2')
方式二
用裝飾器來(lái)實(shí)現(xiàn)自定義過(guò)濾器潮瓶。裝飾器傳入的參數(shù)是自定義的過(guò)濾器名稱。
@app.template_filter('db2')
def do_filterdoublesort(ls):
return ls[::-2]
模版注釋
模板中的注釋使用{# 注釋內(nèi)容 #}
來(lái)定義,不會(huì)出現(xiàn)在生成的HTML中,例如:
{# 我是注釋 #}