在Python的Flask中使用WTForms表单框架的基础教程


Posted in Python onJune 07, 2016

下载和安装
安装 WTForms 最简单的方式是使用 easy_install 和 pip:

easy_install WTForms
# or
pip install WTForms

你可以从 PyPI 手动 下载 WTForms 然后运行 python setup.py install .

如果你是那种喜欢这一切风险的人, 就运行来自 Git 的最新版本, 你能够获取最新变更集的 打包版本, 或者前往 项目主页 克隆代码仓库.

主要概念
Forms 类是 WTForms 的核心容器. 表单(Forms)表示域(Fields)的集合, 域能通过表单的字典形式或者属性形式访问.
Fields(域)做最繁重的工作. 每个域(field)代表一个数据类型, 并且域操作强制表单输入为那个数据类型. 例如, InputRequired 和 StringField 表示两种不同的数据类型. 域除了包含的数据(data)之外, 还包含大量有用的属性, 例如标签、描述、验证错误的列表.
每个域(field)拥有一个Widget(部件)实例. Widget 的工作是渲染域(field)的HTML表示. 每个域可以指定Widget实例, 但每个域默认拥有一个合理的widget. 有些域是简单方便的, 比如 TextAreaField 就仅仅是默认部件(widget) 为 TextArea 的
StringField.
为了指定验证规则, 域包含验证器(Validators)列表.
开始
让我们直接进入正题并定义我们的第一个表单::

from wtforms import Form, BooleanField, StringField, validators

class RegistrationForm(Form):
 username  = StringField('Username', [validators.Length(min=4, max=25)])
 email  = StringField('Email Address', [validators.Length(min=6, max=35)])
 accept_rules = BooleanField('I accept the site rules', [validators.InputRequired()])

当你创建一个表单(form), 你定义域(field)的方法类似于很多ORM定义它们的列(columns):通过定义类变量, 即域的实例.

因为表单是常规的 Python 类, 你可以很容易地把它们扩展成为你期望的::

class ProfileForm(Form):
 birthday = DateTimeField('Your Birthday', format='%m/%d/%y')
 signature = TextAreaField('Forum Signature')

class AdminProfileForm(ProfileForm):
 username = StringField('Username', [validators.Length(max=40)])
 level = IntegerField('User Level', [validators.NumberRange(min=0, max=10)])

通过子类, AdminProfileForm 类获得了已经定义的 ProfileForm 类的所有域. 这允许你轻易地在不同表单之间共享域的共同子集, 例如上面的例子, 我们增加 admin-only 的域到 ProfileForm.

使用表单
使用表单和实例化它一样简单. 想想下面这个django风格的视图函数, 它使用之前定义的 RegistrationForm 类::

def register(request):
 form = RegistrationForm(request.POST)
 if request.method == 'POST' and form.validate():
  user = User()
  user.username = form.username.data
  user.email = form.email.data
  user.save()
  redirect('register')
 return render_response('register.html', form=form)

首先, 我们实例化表单, 给它提供一些 request.POST 中可用的数据. 然后我们检查请求(request)是不是使用 POST 方式, 如果它是, 我们就验证表单, 并检查用户遵守这些规则. 如果成功了, 我们创建新的 User 模型, 并从已验证的表单分派数据给它, 最后保存它.

编辑现存对象

我们之前的注册例子展示了如何为新条目接收输入并验证, 只是如果我们想要编辑现有对象怎么办?很简单::

def edit_profile(request):
 user = request.current_user
 form = ProfileForm(request.POST, user)
 if request.method == 'POST' and form.validate():
  form.populate_obj(user)
  user.save()
  redirect('edit_profile')
 return render_response('edit_profile.html', form=form)

这里, 我们通过给表单同时提供 request.POST 和用户(user)对象来实例化表单. 通过这样做, 表单会从 user 对象得到在未在提交数据中出现的任何数据.

我们也使用表单的populate_obj方法来重新填充用户对象, 用已验证表单的内容. 这个方法提供便利, 用于当域(field)名称和你提供数据的对象的名称匹配时. 通常的, 你会想要手动分配值, 但对于这个简单例子, 它是最好的. 它也可以用于CURD和管理(admin)表单.

在控制台中探索

WTForms 表单是非常简单的容器对象, 也许找出表单中什么对你有用的最简单的方法就是在控制台中玩弄表单:

>>> from wtforms import Form, StringField, validators
>>> class UsernameForm(Form):
...  username = StringField('Username', [validators.Length(min=5)], default=u'test')
...
>>> form = UsernameForm()
>>> form['username']
<wtforms.fields.StringField object at 0x827eccc>
>>> form.username.data
u'test'
>>> form.validate()
False
>>> form.errors
{'username': [u'Field must be at least 5 characters long.']}

我们看到的是当你实例化一个表单的时候, 表单包含所有域的实例, 访问域可以通过字典形式或者属性形式. 这些域拥有它们自己的属性, 就和封闭的表单一样.

当我们验证表单, 它返回逻辑假, 意味着至少一个验证规则不满足. form.errors 会给你一个所有错误的概要.

>>> form2 = UsernameForm(username=u'Robert')
>>> form2.data
{'username': u'Robert'}
>>> form2.validate()
True

这次, 我们实例化 UserForm 时给 username 传送一个新值, 验证表单是足够了.

表单如何获取数据
除了使用前两个参数(formdata和obj)提供数据之外, 你可以传送关键词参数来填充表单. 请注意一些参数名是被保留的: formdata, obj, prefix.

formdata比obj优先级高, obj比关键词参数优先级高. 例如:

def change_username(request):
 user = request.current_user
 form = ChangeUsernameForm(request.POST, user, username='silly')
 if request.method == 'POST' and form.validate():
  user.username = form.username.data
  user.save()
  return redirect('change_username')
 return render_response('change_username.html', form=form)

虽然你在实践中几乎从未一起使用所有3种方式, 举例说明WTForms是如何查找 username 域:

如果表单被提交(request.POST非空), 则处理表单输入. 实践中, 即使这个域没有 表单输入, 而如果存在任何种类的表单输入, 那么我们会处理表单输入.
如果没有表单输入, 则按下面的顺序尝试:

  • 检查 user 是否有一个名为 username 的属性.
  • 检查是否提供一个名为 username 的关键词参数.
  • 最后, 如果都失败了, 使用域的默认值, 如果有的话.

验证器

WTForms中的验证器(Validators)为域(field)提供一套验证器, 当包含域的表单进行验证时运行. 你提供验证器可通过域构造函数的第二个参数validators:

class ChangeEmailForm(Form):
 email = StringField('Email', [validators.Length(min=6, max=120), validators.Email()])

你可以为一个域提供任意数量的验证器. 通常, 你会想要提供一个定制的错误消息:

class ChangeEmailForm(Form):
 email = StringField('Email', [
  validators.Length(min=6, message=_(u'Little short for an email address?')),
  validators.Email(message=_(u'That\'s not a valid email address.'))
 ])

这通常更好地提供你自己的消息, 作为必要的默认消息是通用的. 这也是提供本地化错误消息的方法.

对于内置的验证器的列表, 查阅 Validators.

渲染域
渲染域和强制它为字符串一样简单:

>>> from wtforms import Form, StringField
>>> class SimpleForm(Form):
... content = StringField('content')
...
>>> form = SimpleForm(content='foobar')
>>> str(form.content)
'<input id="content" name="content" type="text" value="foobar" />'
>>> unicode(form.content)
u'<input id="content" name="content" type="text" value="foobar" />'

然而, 渲染域的真正力量来自于它的 __call__() 方法. 调用(calling)域, 你可以提供关键词参数, 它们会在输出中作为HTML属性注入.

>>> form.content(style="width: 200px;", class_="bar")
u'<input class="bar" id="content" name="content" style="width: 200px;" type="text" value="foobar" />'

现在, 让我们应用这个力量在 Jinja 模板中渲染表单. 首先, 我们的表单:

class LoginForm(Form):
 username = StringField('Username')
 password = PasswordField('Password')

form = LoginForm()

然后是模板文件:

<form method="POST" action="/login">
 <div>{{ form.username.label }}: {{ form.username(class="css_class") }}</div>
 <div>{{ form.password.label }}: {{ form.password() }}</div>
</form>

相同的, 如果你使用 Django 模板, 当你想要传送关键词参数时, 你可以使用我们在Django扩展中提供的模板标签form_field:

{% load wtforms %}
<form method="POST" action="/login">
 <div>
  {{ form.username.label }}:
  {% form_field form.username class="css_class" %}
 </div>
 <div>
  {{ form.password.label }}:
  {{ form.password }}
 </div>
</form>

这两个将会输出:

<form method="POST" action="/login">
 <div>
  <label for="username">Username</label>:
  <input class="css_class" id="username" name="username" type="text" value="" />
 </div>
 <div>
  <label for="password">Password</label>:
  <input id="password" name="password" type="password" value="" />
 </div>
</form>

WTForms是模板引擎不可知的, 同时会和任何允许属性存取、字符串强制(string coercion)、函数调用的引擎共事. 在 Django 模板中, 当你不能传送参数时, 模板标签 form_field 提供便利.

显示错误消息
现在我们的表单拥有一个模板, 让我们增加错误消息::

<form method="POST" action="/login">
 <div>{{ form.username.label }}: {{ form.username(class="css_class") }}</div>
 {% if form.username.errors %}
  <ul class="errors">{% for error in form.username.errors %}<li>{{ error }}</li>{% endfor %}</ul>
 {% endif %}

 <div>{{ form.password.label }}: {{ form.password() }}</div>
 {% if form.password.errors %}
  <ul class="errors">{% for error in form.password.errors %}<li>{{ error }}</li>{% endfor %}</ul>
 {% endif %}
</form>

如果你喜欢在顶部显示大串的错误消息, 也很简单:

{% if form.errors %}
 <ul class="errors">
  {% for field_name, field_errors in form.errors|dictsort if field_errors %}
   {% for error in field_errors %}
    <li>{{ form[field_name].label }}: {{ error }}</li>
   {% endfor %}
  {% endfor %}
 </ul>
{% endif %}

由于错误处理会变成相当冗长的事情, 在你的模板中使用 Jinja 宏(macros, 或者相同意义的) 来减少引用是更好的. (例子)

定制验证器
这有两种方式定制的验证器. 通过定义一个定制的验证器并在域中使用它:

from wtforms.validators import ValidationError

def is_42(form, field):
 if field.data != 42:
  raise ValidationError('Must be 42')

class FourtyTwoForm(Form):
 num = IntegerField('Number', [is_42])

或者通过提供一个在表单内的特定域(in-form field-specific)的验证器:

class FourtyTwoForm(Form):
 num = IntegerField('Number')

 def validate_num(form, field):
  if field.data != 42:
   raise ValidationError(u'Must be 42')

编写WTForm扩展示例

class TagListField(Field):
 widget = TextInput()

 def _value(self):
  if self.data:
   return u', '.join(self.data)
  else:
   return u''

 def process_formdata(self, valuelist):
  if valuelist:
   self.data = [x.strip() for x in valuelist[0].split(',')]
  else:
   self.data = []

根据上面的代码,将TagListField中的字符串转为models.py中定义的Tag对象即可:

class TagListField(Field):
 widget = TextInput()

 def __init__(self, label=None, validators=None,
     **kwargs):
  super(TagListField, self).__init__(label, validators, **kwargs)

 def _value(self):
  if self.data:
   r = u''
   for obj in self.data:
    r += self.obj_to_str(obj)
   return u''
  else:
   return u''

 def process_formdata(self, valuelist):
  print 'process_formdata..'
  print valuelist
  if valuelist:
   tags = self._remove_duplicates([x.strip() for x in valuelist[0].split(',')])
   self.data = [self.str_to_obj(tag) for tag in tags]
  else:
   self.data = None

 def pre_validate(self, form):
  pass

 @classmethod
 def _remove_duplicates(cls, seq):
  """去重"""
  d = {}
  for item in seq:
   if item.lower() not in d:
    d[item.lower()] = True
    yield item

 @classmethod
 def str_to_obj(cls, tag):
  """将字符串转换位obj对象"""
  tag_obj = Tag.query.filter_by(name=tag).first()
  if tag_obj is None:
   tag_obj = Tag(name=tag)
  return tag_obj

 @classmethod
 def obj_to_str(cls, obj):
  """将对象转换为字符串"""
  if obj:
   return obj.name
  else:
   return u''

class TagListField(Field):
 widget = TextInput()
 
 def __init__(self, label=None, validators=None,
     **kwargs):
  super(TagListField, self).__init__(label, validators, **kwargs)
 
 def _value(self):
  if self.data:
   r = u''
   for obj in self.data:
    r += self.obj_to_str(obj)
   return u''
  else:
   return u''
 
 def process_formdata(self, valuelist):
  print 'process_formdata..'
  print valuelist
  if valuelist:
   tags = self._remove_duplicates([x.strip() for x in valuelist[0].split(',')])
   self.data = [self.str_to_obj(tag) for tag in tags]
  else:
   self.data = None
 
 def pre_validate(self, form):
  pass
 
 @classmethod
 def _remove_duplicates(cls, seq):
  """去重"""
  d = {}
  for item in seq:
   if item.lower() not in d:
    d[item.lower()] = True
    yield item
 
 @classmethod
 def str_to_obj(cls, tag):
  """将字符串转换位obj对象"""
  tag_obj = Tag.query.filter_by(name=tag).first()
  if tag_obj is None:
   tag_obj = Tag(name=tag)
  return tag_obj
 
 @classmethod
 def obj_to_str(cls, obj):
  """将对象转换为字符串"""
  if obj:
   return obj.name
  else:
   return u''

主要就是在process_formdata这一步处理表单的数据,将字符串转换为需要的数据。最终就可以在forms.py中这样定义表单了:

...
class ArticleForm(Form):
 """编辑文章表单"""

 title = StringField(u'标题', validators=[Required()])
 category = QuerySelectField(u'分类', query_factory=get_category_factory(['id', 'name']), get_label='name')
 tags = TagListField(u'标签', validators=[Required()])
 content = PageDownField(u'正文', validators=[Required()])
 submit = SubmitField(u'发布')
...

...
class ArticleForm(Form):
 """编辑文章表单"""
 
 title = StringField(u'标题', validators=[Required()])
 category = QuerySelectField(u'分类', query_factory=get_category_factory(['id', 'name']), get_label='name')
 tags = TagListField(u'标签', validators=[Required()])
 content = PageDownField(u'正文', validators=[Required()])
 submit = SubmitField(u'发布')
...
在views.py中处理表单就很方便了:


def edit_article():
 """编辑文章"""

 form = ArticleForm()
 if form.validate_on_submit():
  article = Article(title=form.title.data, content=form.content.data)
  article.tags = form.tags.data
  article.category = form.category.data
  try:
   db.session.add(article)
   db.session.commit()
  except:
   db.session.rollback()
 return render_template('dashboard/edit.html', form=form)

def edit_article():
 """编辑文章"""
 
 form = ArticleForm()
 if form.validate_on_submit():
  article = Article(title=form.title.data, content=form.content.data)
  article.tags = form.tags.data
  article.category = form.category.data
  try:
   db.session.add(article)
   db.session.commit()
  except:
   db.session.rollback()
 return render_template('dashboard/edit.html', form=form)

代码是不是很简洁了?^_^。。。

当然了写一个完整的WTForms扩展还是很麻烦的。这里只是刚刚入门。可以看官方扩展QuerySelectField的源码。。。
效果:

在Python的Flask中使用WTForms表单框架的基础教程

Python 相关文章推荐
跟老齐学Python之从if开始语句的征程
Sep 14 Python
python简单实现旋转图片的方法
May 30 Python
SQLite3中文编码 Python的实现
Jan 11 Python
python中virtualenvwrapper安装与使用
May 20 Python
浅谈DataFrame和SparkSql取值误区
Jun 09 Python
Python图片转换成矩阵,矩阵数据转换成图片的实例
Jul 02 Python
对pandas的行列名更改与数据选择详解
Nov 12 Python
Ubuntu18.04下python版本完美切换的解决方法
Jun 14 Python
python super的使用方法及实例详解
Sep 25 Python
python3中numpy函数tile的用法详解
Dec 04 Python
使用PyTorch将文件夹下的图片分为训练集和验证集实例
Jan 08 Python
python GUI库图形界面开发之PyQt5信号与槽机制、自定义信号基础介绍
Feb 25 Python
详解Python的Flask框架中生成SECRET_KEY密钥的方法
Jun 07 #Python
Python的Flask框架中配置多个子域名的方法讲解
Jun 07 #Python
python3批量删除豆瓣分组下的好友的实现代码
Jun 07 #Python
python实现多线程的方式及多条命令并发执行
Jun 07 #Python
python多线程方式执行多个bat代码
Jun 07 #Python
使用rst2pdf实现将sphinx生成PDF
Jun 07 #Python
python监控文件或目录变化
Jun 07 #Python
You might like
PHP实现采集程序原理和简单示例代码
2007/03/18 PHP
微信公众号支付之坑:调用支付jsapi缺少参数 timeStamp等错误解决方法
2016/01/12 PHP
PHP读取XML格式文件的方法总结
2017/02/27 PHP
HTML Dom与Css控制方法
2010/10/25 Javascript
文本框根据输入内容自适应高度的代码
2011/10/24 Javascript
用正则表达式替换图片地址img标签
2013/11/22 Javascript
jQuery+ajax实现实用的点赞插件代码
2016/07/06 Javascript
关于微信中a链接无法跳转问题
2016/08/02 Javascript
vue-cli的webpack模板项目配置文件分析
2017/04/01 Javascript
JavaScript实现图片切换效果
2017/08/12 Javascript
Angular2+国际化方案(ngx-translate)的示例代码
2017/08/23 Javascript
详解nodejs通过响应回写的方式渲染页面资源
2018/04/07 NodeJs
React 使用browserHistory项目访问404问题解决
2018/06/01 Javascript
javascript中UMD规范的代码推演
2018/08/29 Javascript
Vue中Quill富文本编辑器的使用教程
2018/09/21 Javascript
vue实现文字横向无缝走马灯组件效果的实例代码
2019/04/09 Javascript
[01:09:19]DOTA2-DPC中国联赛 正赛 VG vs Aster BO3 第二场 2月28日
2021/03/11 DOTA
浅谈Python中的私有变量
2018/02/28 Python
Python面向对象之反射/自省机制实例分析
2018/08/24 Python
使用Python对Dicom文件进行读取与写入的实现
2020/04/20 Python
浅谈python量化 双均线策略(金叉死叉)
2020/06/03 Python
python获取linux系统信息的三种方法
2020/10/14 Python
详解解决jupyter不能使用pytorch的问题
2021/02/18 Python
西班牙著名的珠宝首饰品牌:P D PAOLA
2018/09/15 全球购物
职高毕业生自我鉴定
2013/10/21 职场文书
电大物流学生的自我评价
2013/10/25 职场文书
编辑硕士自荐信范文
2013/11/27 职场文书
应用心理学个人求职信范文
2013/12/11 职场文书
职业生涯规划设计步骤
2014/01/12 职场文书
土地转让协议书
2014/09/27 职场文书
销售员未完成销售业绩的检讨书
2014/10/12 职场文书
12.4全国法制宣传日活动总结
2014/11/01 职场文书
小学校长开学致辞
2015/07/29 职场文书
Element-ui Layout布局(Row和Col组件)的实现
2021/12/06 Vue.js
分享CSS盒子模型隐藏的几种方式
2022/02/28 HTML / CSS
《辉夜大小姐想让我告白》第三季正式预告
2022/03/20 日漫