使用模板 · 廖雪峰 JavaScript Python Git 教程

{% raw %} # 使用模板 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-seq](https://box.kancloud.cn/2016-01-15_56988a29ef814.png) 這就是傳說中的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](http://jinja.pocoo.org/)，所以我們先直接安裝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`在同級目錄下： ![mvc-dir](https://box.kancloud.cn/2016-01-15_56988a2a0f7d7.png) 啟動`python app.py`，看看使用模板的頁面效果： ![mvc-form](https://box.kancloud.cn/2016-01-15_56988a2a20cc7.png) 通過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](http://www.makotemplates.org/)：用`<% ... %>`和`${xxx}`的一個模板； * [Cheetah](http://www.cheetahtemplate.org/)：也是用`<% ... %>`和`${xxx}`的一個模板； * [Django](https://www.djangoproject.com/)：Django是一站式框架，內置一個用`{% ... %}`和`{{ xxx }}`的模板。 ## 小結有了MVC，我們就分離了Python代碼和HTML代碼。HTML代碼全部放到模板里，寫起來更有效率。 ## 源碼參考 [app.py](https://github.com/michaelliao/learn-python3/blob/master/samples/web/mvc/app.py) {% endraw %}