簡(jiǎn)介:WTForms是一個(gè)Flask集成的框架,或者是說(shuō)庫(kù)。用于處理瀏覽器表單提交的數(shù)據(jù)。它在Flask-WTF 的基礎(chǔ)上擴(kuò)展并添加了一些隨手即得的精巧的幫助函數(shù),這些函數(shù)將會(huì)使在 Flask 里使用表單更加有趣。
安裝:
pip3 install wtforms
WTFForms支持的HTML標(biāo)注字段
字段類(lèi)型 說(shuō) 明
StringField 文本字段
TextAreaField 多行文本字段
PasswordField 密碼文本字段
HiddenField 隱藏文本字段
DateField 文本字段,值為 datetime.date 格式
DateTimeField 文本字段,值為 datetime.datetime 格式
IntegerField 文本字段,值為整數(shù)
DecimalField 文本字段,值為 decimal.Decimal
FloatField 文本字段,值為浮點(diǎn)數(shù)
BooleanField 復(fù)選框,值為 True 和 False
RadioField 一組單選框
SelectField 下拉列表
SelectMultipleField 下拉列表,可選擇多個(gè)值
FileField 文件上傳字段
SubmitField 表單提交按鈕
FormField 把表單作為字段嵌入另一個(gè)表單
FieldList 一組指定類(lèi)型的字段
WTForms 內(nèi)建的Validators驗(yàn)證函數(shù)
函數(shù) 說(shuō)明
Email 驗(yàn)證電子郵件地址
EqualTo 比較兩個(gè)字段的值;常用于要求輸入兩次密碼進(jìn)行確認(rèn)的情況
IPAddress 驗(yàn)證 IPv4 網(wǎng)絡(luò)地址
Length 驗(yàn)證輸入字符串的長(zhǎng)度
NumberRange 驗(yàn)證輸入的值在數(shù)字范圍內(nèi)
Optional 無(wú)輸入值時(shí)跳過(guò)其他驗(yàn)證函數(shù)
Required 確保字段中有數(shù)據(jù)
Regexp 使用正則表達(dá)式驗(yàn)證輸入值
URL 驗(yàn)證 URL
AnyOf 確保輸入值在可選值列表中
NoneOf 確保輸入值不在可選值列表中
自定義Validators驗(yàn)證器
-
in-line validator(內(nèi)聯(lián)驗(yàn)證器)
也就是自定義一個(gè)驗(yàn)證函數(shù),在定義表單類(lèi)的時(shí)候,在對(duì)應(yīng)的字段中加入該函數(shù)進(jìn)行認(rèn)證。下面的my_length_check函數(shù)就是用于判name字段長(zhǎng)度不能超過(guò)50.
def my_length_check(form, field):
if len(field.data) > 50:
raise ValidationError('Field must be less than 50 characters')
class MyForm(Form):
name = StringField('Name', [InputRequired(), my_length_check])
-
通用且可重用的驗(yàn)證函數(shù)
一般是以validate開(kāi)頭,加上下劃線再加上對(duì)應(yīng)的field字段(validate_filed),瀏覽器在提交表單數(shù)據(jù)時(shí),會(huì)自動(dòng)識(shí)別對(duì)應(yīng)字段所有的驗(yàn)證器,然后執(zhí)行驗(yàn)證器進(jìn)行判斷。class RegistrationForm(FlaskForm): email = StringField('Email', validators=[DataRequired(), Length(1, 60), Email()]) username = StringField('Username', validators=[DataRequired(), Length(1, 60), Regexp('^[A-Za-z][A-Za-z0-9_.]*$', 0, 'username must have only letters, numbers dots or underscores')]) password = PasswordField('Password', validators=[DataRequired(), EqualTo('password2', message='password must match')]) password2 = PasswordField('Confirm password', validators=[DataRequired()]) def validate_email(self, field): if User.objects.filter(email=field.data).count() > 0: raise ValidationError('Email already registered') def validate_username(self, field): if User.objects.filter(username=field.data).count() > 0: raise ValidationError('Username has exist')Widget組件
登錄界面為實(shí)例:
from wtforms import StringField, PasswordField, BooleanField, validators, widgets, Form from wtforms.fields import html5, simple class LoginForm(Form): username = StringField( label="username:", validators=[ validators.DataRequired(message='用戶(hù)名不能為空.')], widget=widgets.TextInput(), ) password = PasswordField( label='password:', validators=[ validators.DataRequired(message='密碼不能為空.'), validators.Length(min=8, message='密碼長(zhǎng)度必須大于%(min)d'), ], widget=widgets.PasswordInput(), )總結(jié)
flask表單這一部分我們都是使用Flask-WTF和WTForms來(lái)做的,我們可以通過(guò)做一些簡(jiǎn)單的demo來(lái)加強(qiáng)理解他們的原理并且強(qiáng)化flask的基礎(chǔ)。
參考鏈接:http://m.itdecent.cn/p/7e16877757f8
每天多努力那么一點(diǎn)點(diǎn),積少成多