雷林鵬分享：Flask WTF

　　Web應用程序的一個重要方面是爲用戶提供一個用戶界面。 HTML提供了一個

標籤，用於設計一個接口。 能夠適當使用表單的元素，如文本輸入，廣播，選擇等。

 

　　經過GET或POST方法將用戶輸入的數據以Http請求消息的形式提交給服務器端腳本。

　　服務器端腳本必須從http請求數據從新建立表單元素。 因此實際上，表單元素必須被定義兩次 - 一次是HTML，一次是服務器端腳本。

　　使用HTML表單的另外一個缺點是很難(若是不是不可能)動態地呈現表單元素。 HTML自己沒法驗證用戶的輸入。

　　這就是WTForms，一個靈活的表單，渲染和驗證庫來得方便的地方。 Flask-WTF擴展爲這個WTForms庫提供了一個簡單的接口。

　　使用Flask-WTF，能夠在Python腳本中定義表單域並使用HTML模板來呈現它們。 也能夠將驗證應用於WTF字段。

　　下面讓咱們看看這個動態生成HTML是如何工做的。

　　首先，須要安裝Flask-WTF擴展。

　　pip install flask-WTF

　　已安裝的軟件包包含一個Form類，該類必須用做用戶定義表單的父級。WTforms包包含各類表單域的定義。下面列出了一些標準表單字段。

　　編號標準表單字段描述

　　1TextField表示 HTML表單元素

　　2BooleanField表示 HTML表單元素

　　3DecimalField用小數顯示數字的文本字段

　　4IntegerField用於顯示整數的文本字段

　　5RadioField表示的HTML表單元素

　　6SelectField表示選擇表單元素

　　7TextAreaField表示 html表單元素

　　8PasswordField表示 HTML表單元素

　　9SubmitField表示表單元素

　　例如，能夠設計一個包含文本字段的表單，以下所示 -

　　from flask_wtf import Form

　　from wtforms import TextField

　　class ContactForm(Form):

　　name = TextField("Name Of Student")

　　除了name字段以外，還會自動建立一個CSRF令牌的隱藏字段。 這是爲了防止跨站請求僞造攻擊。

　　渲染時，這將產生一個等效的HTML腳本，以下所示。

　　

　　Name Of Student

　　

　　用戶定義的表單類在Flask應用程序中使用，表單使用模板呈現。

　　from flask import Flask, render_template

　　from forms import ContactForm

　　app = Flask(__name__)

　　app.secret_key = 'development key'

　　@app.route('/contact')

　　def contact():

　　form = ContactForm()

　　return render_template('contact.html', form = form)

　　if __name__ == '__main__':

　　app.run(debug = True)

　　WTForms包也包含驗證器類，在驗證表單域時很是有用。 如下列表顯示了經常使用的驗證器。

　　編號驗證器類描述

　　1DataRequired檢查輸入欄是否爲空

　　2Email檢查字段中的文本是否遵循電子郵件ID約定

　　3IPAddress驗證輸入字段中的IP地址

　　4Length驗證輸入字段中字符串的長度是否在給定範圍內

　　5NumberRange在給定範圍內的輸入字段中驗證一個數字

　　6URL驗證輸入字段中輸入的URL

　　將聯繫表單的name字段應用'DataRequired'驗證規則。

　　name = TextField("Name Of Student",[validators.Required("Please enter your name.")])

　　表單對象的validate()函數驗證表單數據，並在驗證失敗時拋出驗證錯誤。 錯誤消息被髮送到模板。 在HTML模板中，錯誤消息是動態呈現的。

　　{% for message in form.name.errors %}

　　{{ message }}

　　{% endfor %}

　　如下示例演示了上面給出的概念。聯繫人表單代碼以下(forms.py)。

　　from flask_wtf import Form

　　from wtforms import TextField, IntegerField, TextAreaField, SubmitField, RadioField, SelectField

　　from wtforms import validators, ValidationError

　　class ContactForm(Form):

　　name = TextField("學生姓名",[validators.Required("Please enter your name.")])

　　Gender = RadioField('性別', choices = [('M','Male'),('F','Female')])

　　Address = TextAreaField("地址")

　　email = TextField("Email",[validators.Required("Please enter your email address."),

　　validators.Email("Please enter your email address.")])

　　Age = IntegerField("年齡")

　　language = SelectField('語言', choices = [('cpp', 'C++'), ('py', 'Python')])

　　submit = SubmitField("提交")

　　驗證器應用於名稱和電子郵件字段。下面給出的是Flask應用程序腳本(formexample.py)。

　　from flask import Flask, render_template, request, flash

　　from forms import ContactForm

　　app = Flask(__name__)

　　app.secret_key = 'development key'

　　@app.route('/contact', methods = ['GET', 'POST'])

　　def contact():

　　form = ContactForm()

　　if request.method == 'POST':

　　if form.validate() == False:

　　flash('All fields are required.')

　　return render_template('contact.html', form = form)

　　else:

　　return render_template('success.html')

　　elif request.method == 'GET':

　　return render_template('contact.html', form = form)

　　if __name__ == '__main__':

　　app.run(debug = True)

　　模板的腳本(contact.html)以下所示 -

　　

　　

　　

　　

　　

　　

　　

聯繫人表單

 

　　{% for message in form.name.errors %}

　　

{{ message }}

 

　　{% endfor %}

　　{% for message in form.email.errors %}

　　

{{ message }}

 

　　{% endfor %}

　　

　　

 

　　

填寫項

　　{{ form.hidden_tag() }}

　　

 

　　{{ form.name.label }}

　　{{ form.name }}

　　

　　{{ form.Gender.label }} {{ form.Gender }}

　　{{ form.Address.label }}

　　{{ form.Address }}

　　

　　{{ form.email.label }}

　　{{ form.email }}

　　

　　{{ form.Age.label }}

　　{{ form.Age }}

　　

　　{{ form.language.label }}

　　{{ form.language }}

　　

　　{{ form.submit }}

　　

 

　　

 

　　

 

　　

　　

　　在Python shell中運行formexample.py，並訪問URL => http://localhost:5000/contact 。 聯繫人表單將顯示以下。

　　若是有錯誤信息，頁面將以下所示 -

　　若是沒有錯誤，將呈現success.html頁面的內容，以下所示 -

(編輯：雷林鵬 來源：網絡 侵刪)