005.web框架使用模板
Web框架把我們從WSGI中拯救出來了。現在,我們只需要不斷地編寫函式,帶上URL,就可以繼續Web App的開發了。
但是,Web App不僅僅是處理邏輯,展示給使用者的頁面也非常重要。在函式中返回一個包含HTML的字串,簡單的頁面還可以,但是,想想新浪首頁的6000多行的HTML,你確信能在Python的字串中正確地寫出來麼?反正我是做不到。
俗話說得好,不懂前端的Python工程師不是好的產品經理。有Web開發經驗的同學都明白,Web App最複雜的部分就在HTML頁面。HTML不僅要正確,還要通過CSS美化,再加上覆雜的JavaScript指令碼來實現各種互動和動畫效果。總之,生成HTML頁面的難度很大。
由於在Python程式碼裡拼字串是不現實的,所以,模板技術出現了。
使用模板,我們需要預先準備一個HTML文件,這個HTML文件不是普通的HTML,而是嵌入了一些變數和指令,然後,根據我們傳入的資料,替換後,得到最終的HTML,傳送給使用者:
這就是傳說中的MVC:Model-View-Controller,中文名“模型-檢視-控制器”。
Python處理URL的函式就是C:Controller,Controller負責業務邏輯,比如檢查使用者名稱是否存在,取出使用者資訊等等;
包含變數{{ name }}
的模板就是V:View,View負責顯示邏輯,通過簡單地替換一些變數,View最終輸出的就是使用者看到的HTML。
MVC中的Model在哪?Model是用來傳給View的,這樣View在替換變數的時候,就可以從Model中取出相應的資料。
上面的例子中,Model就是一個dict
:
{ 'name': 'Michael' }
只是因為Python支援關鍵字引數,很多Web框架允許傳入關鍵字引數,然後,在框架內部組裝出一個dict
作為Model。
現在,我們把上次直接輸出字串作為HTML的例子用高階大氣上檔次的MVC模式改寫一下:
from flask import Flask, request, render_template app = Flask(__name__) @app.route('/', methods=['GET', 'POST']) def home(): return render_template('home.html') @app.route('/signin', methods=['GET']) def signin_form(): return render_template('form.html') @app.route('/signin', methods=['POST']) def signin(): username = request.form['username'] password = request.form['password'] if username=='admin' and password=='password': return render_template('signin-ok.html', username=username) return render_template('form.html', message='Bad username or password', username=username) if __name__ == '__main__': app.run()
Flask通過render_template()
函式來實現模板的渲染。和Web框架類似,Python的模板也有很多種。Flask預設支援的模板是jinja2,所以我們先直接安裝jinja2:
$ pip install jinja2
然後,開始編寫jinja2模板:
home.html
用來顯示首頁的模板:
<html>
<head>
<title>Home</title>
</head>
<body>
<h1 style="font-style:italic">Home</h1>
</body>
</html>
form.html
用來顯示登入表單的模板:
<html>
<head>
<title>Please Sign In</title>
</head>
<body>
{% if message %}
<p style="color:red">{{ message }}</p>
{% endif %}
<form action="/signin" method="post">
<legend>Please sign in:</legend>
<p><input name="username" placeholder="Username" value="{{ username }}"></p>
<p><input name="password" placeholder="Password" type="password"></p>
<p><button type="submit">Sign In</button></p>
</form>
</body>
</html>
signin-ok.html
登入成功的模板:
<html>
<head>
<title>Welcome, {{ username }}</title>
</head>
<body>
<p>Welcome, {{ username }}!</p>
</body>
</html>
登入失敗的模板呢?我們在form.html
中加了一點條件判斷,把form.html
重用為登入失敗的模板。
最後,一定要把模板放到正確的templates
目錄下,templates
和app.py
在同級目錄下:
啟動python app.py
,看看使用模板的頁面效果:
通過MVC,我們在Python程式碼中處理M:Model和C:Controller,而V:View是通過模板處理的,這樣,我們就成功地把Python程式碼和HTML程式碼最大限度地分離了。
使用模板的另一大好處是,模板改起來很方便,而且,改完儲存後,重新整理瀏覽器就能看到最新的效果,這對於除錯HTML、CSS和JavaScript的前端工程師來說實在是太重要了。
在Jinja2模板中,我們用{{ name }}
表示一個需要替換的變數。很多時候,還需要迴圈、條件判斷等指令語句,在Jinja2中,用{% ... %}
表示指令。
比如迴圈輸出頁碼:
{% for i in page_list %}
<a href="/page/{{ i }}">{{ i }}</a>
{% endfor %}
如果page_list
是一個list:[1, 2, 3, 4, 5]
,上面的模板將輸出5個超連結。
除了Jinja2,常見的模板還有:
-
Mako:用
<% ... %>
和${xxx}
的一個模板; -
Cheetah:也是用
<% ... %>
和${xxx}
的一個模板; -
Django:Django是一站式框架,內建一個用
{% ... %}
和{{ xxx }}
的模板。
小結
有了MVC,我們就分離了Python程式碼和HTML程式碼。HTML程式碼全部放到模板裡,寫起來更有效率。