Flask模板操作二：高級操作之自定義過濾器，控制代碼塊和模板代碼復用,模板中特有的變量和函數

自定義過濾器

過濾器的本質是函數。當模板內置的過濾器不能滿足需求，可以自定義過濾器。自定義過濾器有兩種實現方式：

• 一種是通過Flask應用對象的 add_template_filter 方法

• 通過裝飾器來實現自定義過濾器

重要：自定義的過濾器名稱如果和內置的過濾器重名，會覆蓋內置的過濾器。

需求：添加列表反轉的過濾器

方式一

通過調用應用程序實例的 add_template_filter 方法實現自定義過濾器。該方法第一個參數是函數名，第二個參數是自定義的過濾器名稱：

def do_listreverse(li):
    # 通過原列表創建一個新列表
    temp_li = list(li)    # 將新列表進行返轉
    temp_li.reverse()    return temp_li

app.add_template_filter(do_listreverse,'lireverse')

方式二

用裝飾器來實現自定義過濾器。裝飾器傳入的參數是自定義的過濾器名稱。

@app.template_filter('lireverse')def do_listreverse(li):
    # 通過原列表創建一個新列表
    temp_li = list(li)    # 將新列表進行返轉
    temp_li.reverse()    return temp_li

• 在 html 中使用該自定義過濾器

<br/> my_array 原內容：{{ my_array }}<br/> my_array 反轉：{{ my_array | lireverse }}

• 運行結果

my_array 原內容：[3, 4, 2, 1, 7, 9] 
my_array 反轉：[9, 7, 1, 2, 4, 3]

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

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

控制代碼塊

控制代碼塊主要包含兩個：

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

if語句

Jinja2 語法中的if語句跟 Python 中的 if 語句相似,后面的布爾值或返回布爾值的表達式將決定代碼中的哪個流程會被執行:

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

過濾器可以被用在 if 語句中:

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

循環

• 我們可以在 Jinja2 中使用循環來迭代任何列表或者生成器函數

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

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

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

• 在一個 for 循環塊中你可以訪問這些特殊的變量:

• 在循環內部,你可以使用一個叫做loop的特殊變量來獲得關于for循環的一些信息

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

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

• 會輸出這樣的結果

1, Post title2, Second Post

• cycle函數會在每次循環的時候,返回其參數中的下一個元素,可以拿上面的例子來說明:

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

• 會輸出這樣的結果：

odd Post Title
even Second Post

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

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

模板代碼復用

在模板中，可能會遇到以下情況：

• 多個模板具有完全相同的頂部和底部內容

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

• 多個模板中具有完全相同的 html 代碼塊內容

像遇到這種情況，可以使用 JinJa2 模板中的 繼承來進行實現

{% block top %} {% endblock %}

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

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

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

{% extends 'base.html' %}
{% block content %}
 需要填充的內容
{% endblock content %}

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

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

模板中特有的變量和函數

你可以在自己的模板中訪問一些 Flask 默認內置的函數和對象

config

你可以從模板中直接訪問Flask當前的config對象:

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

request

就是flask中代表當前請求的request對象：

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

g變量

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

{{ g.name }}

get_flashed_messages()

這個函數會返回之前在flask中通過flask()傳入的消息的列表，flash函數的作用很簡單,可以把由Python字符串表示的消息加入一個消息隊列中，再使用get_flashed_message()函數取出它們并消費掉：

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