1. 程式人生 > >005.web框架使用模板

005.web框架使用模板

https://www.liaoxuefeng.com/wiki/0014316089557264a6b348958f449949df42a6d3a2e542c000/0014320129740415df73bf8f81e478982bf4d5c8aa3817a000

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

這就是傳說中的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目錄下,templatesapp.py在同級目錄下:

mvc-dir

啟動python app.py,看看使用模板的頁面效果:

mvc-form

通過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程式碼全部放到模板裡,寫起來更有效率。

原始碼參考

app.py