Flask模板操作二：高級(jí)操作之自定義過(guò)濾器，控制代碼塊和模板代碼復(fù)用,模板中特有的變量和函數(shù)

自定義過(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ò)濾器。

需求：添加列表反轉(zhuǎn)的過(guò)濾器

方式一

通過(guò)調(diào)用應(yīng)用程序?qū)嵗?add_template_filter 方法實(shí)現(xiàn)自定義過(guò)濾器。該方法第一個(gè)參數(shù)是函數(shù)名，第二個(gè)參數(shù)是自定義的過(guò)濾器名稱：

def do_listreverse(li):
    # 通過(guò)原列表創(chuàng)建一個(gè)新列表
    temp_li = list(li)    # 將新列表進(jìn)行返轉(zhuǎn)
    temp_li.reverse()    return temp_li

app.add_template_filter(do_listreverse,'lireverse')

方式二

用裝飾器來(lái)實(shí)現(xiàn)自定義過(guò)濾器。裝飾器傳入的參數(shù)是自定義的過(guò)濾器名稱。

@app.template_filter('lireverse')def do_listreverse(li):
    # 通過(guò)原列表創(chuàng)建一個(gè)新列表
    temp_li = list(li)    # 將新列表進(jìn)行返轉(zhuǎn)
    temp_li.reverse()    return temp_li

• 在 html 中使用該自定義過(guò)濾器

<br/> my_array 原內(nèi)容：{{ my_array }}<br/> my_array 反轉(zhuǎn)：{{ my_array | lireverse }}

• 運(yùn)行結(jié)果

my_array 原內(nèi)容：[3, 4, 2, 1, 7, 9] 
my_array 反轉(zhuǎn)：[9, 7, 1, 2, 4, 3]

==================================================================================================

==================================================================================================

控制代碼塊

控制代碼塊主要包含兩個(gè)：

- if/else if /else / endif
- for / endfor

if語(yǔ)句

Jinja2 語(yǔ)法中的if語(yǔ)句跟 Python 中的 if 語(yǔ)句相似,后面的布爾值或返回布爾值的表達(dá)式將決定代碼中的哪個(gè)流程會(huì)被執(zhí)行:

{%if user.is_logged_in() %}
    <a href='/logout'>Logout</a>
{% else %}
    <a href='/login'>Login</a>
{% endif %}

過(guò)濾器可以被用在 if 語(yǔ)句中:

{% if comments | length > 0 %}
    There are {{ comments | length }} comments
{% else %}
    There are no comments
{% endif %}

循環(huán)

• 我們可以在 Jinja2 中使用循環(huán)來(lái)迭代任何列表或者生成器函數(shù)

{% for post in posts %}
    <div>
        <h2>{{ post.title }}</h2>
        <p>{{ post.text | safe }}</p>
    </div>
{% endfor %}

• 循環(huán)和if語(yǔ)句可以組合使用，以模擬 Python 循環(huán)中的 continue 功能，下面這個(gè)循環(huán)將只會(huì)渲染post.text不為None的那些post：

{% for post in posts if post.text %}
    <div>
        <h2>{{ post.title }}</h2>
        <p>{{ post.text | safe }}</p>
    </div>
{% endfor %}

• 在一個(gè) for 循環(huán)塊中你可以訪問(wèn)這些特殊的變量:

• 在循環(huán)內(nèi)部,你可以使用一個(gè)叫做loop的特殊變量來(lái)獲得關(guān)于for循環(huán)的一些信息

• 比如：要是我們想知道當(dāng)前被迭代的元素序號(hào)，并模擬Python中的enumerate函數(shù)做的事情，則可以使用loop變量的index屬性,例如:

{% for post in posts%}
{{loop.index}}, {{post.title}}
{% endfor %}

• 會(huì)輸出這樣的結(jié)果

1, Post title2, Second Post

• cycle函數(shù)會(huì)在每次循環(huán)的時(shí)候,返回其參數(shù)中的下一個(gè)元素,可以拿上面的例子來(lái)說(shuō)明:

{% for post in posts%}
{{loop.cycle('odd','even')}} {{post.title}}
{% endfor %}

• 會(huì)輸出這樣的結(jié)果：

odd Post Title
even Second Post

==================================================================================================

==================================================================================================

模板代碼復(fù)用

在模板中，可能會(huì)遇到以下情況：

• 多個(gè)模板具有完全相同的頂部和底部?jī)?nèi)容

• 多個(gè)模板中具有相同的模板代碼內(nèi)容，但是內(nèi)容中部分值不一樣

• 多個(gè)模板中具有完全相同的 html 代碼塊內(nèi)容

像遇到這種情況，可以使用 JinJa2 模板中的 繼承來(lái)進(jìn)行實(shí)現(xiàn)

{% block top %} {% endblock %}

{% block top %}
  頂部菜單
{% endblock top %}

{% block content %}
{% endblock content %}

{% block bottom %}
  底部
{% endblock bottom %}

{% extends 'base.html' %}
{% block content %}
 需要填充的內(nèi)容
{% endblock content %}

==================================================================================================

==================================================================================================

模板中特有的變量和函數(shù)

你可以在自己的模板中訪問(wèn)一些 Flask 默認(rèn)內(nèi)置的函數(shù)和對(duì)象

config

你可以從模板中直接訪問(wèn)Flask當(dāng)前的config對(duì)象:

{{config.SQLALCHEMY_DATABASE_URI}}
sqlite:///database.db

request

就是flask中代表當(dāng)前請(qǐng)求的request對(duì)象：

{{request.url}}
http://127.0.0.1

g變量

在視圖函數(shù)中設(shè)置g變量的 name 屬性的值，然后在模板中直接可以取出

{{ g.name }}

get_flashed_messages()

這個(gè)函數(shù)會(huì)返回之前在flask中通過(guò)flask()傳入的消息的列表，flash函數(shù)的作用很簡(jiǎn)單,可以把由Python字符串表示的消息加入一個(gè)消息隊(duì)列中，再使用get_flashed_message()函數(shù)取出它們并消費(fèi)掉：

{%for message in get_flashed_messages()%}
    {{message}}
{%endfor%}