模伴是一個包含響應文本的文件衫仑,其中包含用占位變量表示的動態(tài)部分,具體值只有在請求的上下文(request)中才能獲取巍棱。
處理模板時惑畴,使用真實變量替換占位變量,再返回最終得到的響應字符串(文件)航徙,這一過程稱為渲染如贷,F(xiàn)lask使用了Jinjia2這一強大的模板引擎進行渲染操作。
一到踏、Jinjia2 模版引擎
1杠袱、渲染模板
# user.html
<h1>Hello , {{ name }} </h1>
默認情況下,flask在程序根目錄下的templates文件夾中尋找模板窝稿。
from flask import Flask, render_template
# flask提供的render_template函數將Jinjia2模版引擎集成到程序中
···
@app.route('/user/<name>'
def user(name):
return render_template('user.html', name=name)
上述代碼展示了render_template如何將動態(tài)變量傳給模板并進行渲染
render_template函數接收多個參數楣富,但第一個參數必須為模板文件名稱,后續(xù)為表示動態(tài)變量的鍵值對伴榔。
2纹蝴、變量
在模板中使用"{{ name }}",雙大括號結構表示一個變量踪少,是模板特有的占位符塘安,用以告訴模板引擎這個位置從渲染模板時使用的數據中獲取。
Jinjia2能識別所有類型的變量援奢,包含復雜的(列表兼犯,字典,對象)集漾。
# 復雜類型示例
{{ dict['key'] }}
{{ list[3] }}
{{ obj.somemethod() }}
并且Jinjia2支持使用過濾器修改變量切黔,過濾器名添加在變量名之后,用豎線隔開具篇。
{{ name | capitalize }}
3纬霞、控制結構
Jinjia2提供了多種控制結構用來改變模板的渲染流程。
{% if user %}
hello, {{ user }}
{% else %}
hello, Stranger!
{% endif %} #控制語句結束后必須使用 {% end+if/for...%}關閉
<ul>
{% for comment in comments %}
<li>{{ comment }}</li>
{% endfor %}
</ul>
模板繼承
{% extends "base.html" %}
{% block title %}
Index #為父模板的title標簽添加內容
{% endblock %}
{% block head%}
{{ super() }} #獲取父模版head標簽內的內容
{% endblock %}
二驱显、Flask-Bootstrap
Bootstrap是Twitter開發(fā)的一個客戶端開源框架诗芜,并不會直接設計服務器內容侨舆。
服務器需要做的是提供引用了Bootstrap CSS和JS文件的HTML響應,并在HTML绢陌、CSS和JS中實例化所需組件,這些操作最理想的執(zhí)行場所就是模板熔恢。
pip install flask-bootstrap #安裝
from flask.ext.bootstrap import Bootstrap #引入
#···
bootstrap = Bootstrap(app) #初始化
使用extends指令從flask-bootstrap中導入bootstrap/base.html脐湾,從而實現(xiàn)模板繼承。
該基模版提供了一個網頁框架叙淌,引入Bootstrap所需的所有CSS秤掌、JS文件。
如果需要對已有內容的模版添加新內容鹰霍,必須使用Jinjia2提供的super()函數
{% block scripts %}
{{ super() }}
<script type="text/javascript" src="my-script.js"></script>
{% endblock %}
三闻鉴、自定義錯誤頁面
為指定錯誤代碼自定義錯誤處理程序
@app.errorhandler(404):
def page_not_found(e):
return render_template('404.html'), 404
需要編寫404.html模版,繼承base.html茂洒,并將head元素改為相應的錯誤信息孟岛。
為了避免過多的代碼重復以及將錯誤信息展示在合適的頁面,編寫handle.html模板督勺,繼承自bootstrap/base.html渠羞,將導航條及其他基本框架必備信息寫入,再新建404.html繼承handle.html模板。
{% extends "handle.html" %}
{% block title %}Page Not Found {% endblock %}
{% block page_content %} <h1>Not Found</h1>{% endblock %}
四、鏈接
任何具有多個路由的程序都需要可以連接不同頁面的鏈接(例:導航條)
flask提供了url_for()輔助函數茫负,可以使程序URL映射中保存的信息生成URL疆导。
url_for()最簡單的用法是以視圖函數名作為參數,返回對應的URL惑灵。
使用url_for()生成動態(tài)地址時,將動態(tài)部分作為關鍵字參數傳入。
傳入url_for()的關鍵字參數不僅限于動態(tài)路由中的參數盒卸,函數能將任何額外的參數添加到查詢字符串中,例:url_for('index', page=2) = /?page=2
五辨嗽、靜態(tài)文件
靜態(tài)文件作為Web程序的重要組成部分(CSS世落、JavaScript、圖片等)
默認設置下糟需,flask會在程序根目錄中名為static的子目錄中尋找靜態(tài)文件屉佳。
使用Flask-Moment本地化日期和時間
pip install flask-moment
from flask.ext.moment import Moment
moment = Moment(app)
當Web程序服務器不同地區(qū)和國家的用戶時,日期顯示是個非常關鍵的問題洲押,一般來說要根據用戶本地的時區(qū)來提供給用戶本地化的時間武花。
flask-moment 是使用javascript開發(fā)的優(yōu)秀客戶端開源代碼庫,它可以在瀏覽器中渲染日期和時間杈帐。
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}
將時間變量傳給模板進行渲染
#視圖函數
from datetime import datetime
@app.route('/')
def index():
return render_template('index.html', current_time=datetime.utcnow())
#模板
<p>That was {{ moment(current_time).format('LLL') }}</p>
<p>That was {{ moment(current_time).fromNow(refresh=True) }}</p>
format('LLL')根據客戶端電腦中的時區(qū)和區(qū)域設置渲染日期和時間体箕,參數決定了渲染的方式专钉,‘L’到‘LLL’分別對應不同的復雜度。
fromNow()渲染相對時間戳累铅,而且會隨著時間推移自動刷新顯示的時間跃须,最開始顯示為"a few seconds ago",逐步變成"a minute ago"娃兽。