Flask学习记录之Flask-WTF

Flask-wtf时Wtforms库的flask框架扩展,能够方便的处理Web表单

一.定义一个web表单

使用flask-wtf时,每个web表单都由一个继承自flask.ext.wtf.Form的类表示,每个字段都由类中的属性表示,每个字段可以附属多个验证函数

from flask.ext.wtf import Form
from wtforms import StringField, PasswordField, SubmitField
from wtforms.validators import DataRequired,EqualTo class RegForm(Form):
username = StringField('Username',validators=[DataRequired()])
password = PasswordField('password', validators=[DataRequired()])
password1 = PasswordField('confirm password', validators=[DataRequired(),
EqualTo('password', 'password not match')
                                    ])
submit = SubmitField("submit")

这里定义了一个注册用户的表单,password1需要与password填写一样,字段的第一个属性是表单名,在validators中可以使用不同的验证器

二.使用表单

向模版中传入一个表单实例来渲染表单

@app.route('/reg', methods=('GET', 'POST'))
def reg():
form = RegForm()
#验证表单输入内容是否符合要求
if form.validate_on_submit():
#获取表单提交的内容
return "name:%r,password:%r"%(form.username.data,form.password.data)
return render_template('reg.html', form=form)

模版中

 <form action="" method="post" name="login">
{{form.hidden_tag()}}
<p>
Please enter your Name:<br>
{{form.name(size=80)}}<br>
</p>
<p>
Password:<br>
{{ form.password }}
</p>
<p>
Password:<br>
{{ form.password1 }}
</p>
<p>{{ form.submit }}</p>
</form>

form.hidden_tag() 模板参数将被替换为一个隐藏字段,用来是实现在配置中激活的 CSRF 保护。如果你已经激活了 CSRF,这个字段需要出现在你所有的表单中。

Flask-Bootst 提供了快捷的表单显示函数,如可直接使用:

{% extends 'base.html' %}
{% import 'bootstrap/wtf.html' as wtf%}
{% block page_content %} {{ wtf.quick_form(form) }} {% endblock %}

三.自定义表单验证

可以自定义表单的验证方式,比如如果数据库已经有了一个用户名就不能再注册同名的用户了,

....
from wtforms import ValidationError
....
class RegForm(Form):
....
#验证username字段时会自动调用这个函数
def validate_username(self,field):
if field.data == 'agmcs':
#抛出的异常提示可作为提示显示
raise ValidationError("the username is already exist")

四.Select控件的使用

class EditProfileAdminForm(Form):
role = SelectField('Role', coerce=int)
#在构造化Form实例时指定selectField的choices内容,
def __init__(self, *args, **kwargs):
super(EditProfileAdminForm, self).__init__( *args,
**kwargs)
self.role.choices = [(role.id, role.name) for role in Role.query.order_by(Role.name).all()]
#choices需要一个列表里面包含数个键值对应的元组 #也可以在初始化后使用form.role.choices = [(role.id, role.name) for role in Role.query.order_by(Role.name).all()] 来添加选项

没有使用Flask-bootstrap的话可以使用如下代码显示:

<div class="form-group" id='cg-{{form.role.id}}'>
{{form.role.label(class='col-lg-2 control-label',for=form.role.id)}}
<div class="col-lg-9">
{{form.role(class='form-control')}}
<span class="help-block" id='hl-{{form.role.id}}'></span>
</div>
</div

五.自定义表单的属性

刚才需要在flask-admin中替换TextArea为CKEDitor,这样就只能在代码中替换,可是ckeditor需要将textarea的class设置成ckedtor,上网查了一下,可以自己定义一个控件属性

明天写//

上一篇:Swift 3.0首个开发者预览版将在5月12日释出


下一篇:Yii与表单交互的三种模式2