在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 相关文章推荐
python3实现读取chrome浏览器cookie
Jun 19 Python
Python+OpenCV人脸检测原理及示例详解
Oct 19 Python
python获取当前目录路径和上级路径的实例
Apr 26 Python
python numpy格式化打印的实例
May 14 Python
matplotlib savefig 保存图片大小的实例
May 24 Python
Django框架实现的简单分页功能示例
Dec 04 Python
python利用Opencv实现人脸识别功能
Apr 25 Python
python过滤中英文标点符号的实例代码
Jul 15 Python
TensorFlow固化模型的实现操作
May 26 Python
Python性能分析工具py-spy原理用法解析
Jul 27 Python
Python如何telnet到网络设备
Feb 18 Python
10个顶级Python实用库推荐
Mar 04 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递归函数返回值使用方法
2013/02/18 PHP
PHP中session变量的销毁
2014/02/27 PHP
微信红包随机生成算法php版
2016/07/21 PHP
PHP实现redis限制单ip、单用户的访问次数功能示例
2018/06/16 PHP
PHP安装扩展mcrypt以及相关依赖项深入讲解
2021/03/04 PHP
javaScript中的this示例学习详解及工作原理
2014/01/13 Javascript
drag-and-drop实现图片浏览器预览
2015/08/06 Javascript
Javascript实现Array和String互转换的方法
2015/12/21 Javascript
javascript自动切换焦点控制效果完整实例
2016/02/02 Javascript
详解vue express启动数据服务
2017/07/05 Javascript
将jquery.qqFace.js表情转换成微信的字符码
2017/12/01 jQuery
jquery自定义显示消息数量
2017/12/19 jQuery
妙用缓存调用链实现JS方法的重载
2018/04/30 Javascript
vue-cli脚手架build目录下utils.js工具配置文件详解
2018/09/14 Javascript
layer 关闭指定弹出层的例子
2019/09/25 Javascript
js实现图片上传到服务器和回显
2020/01/19 Javascript
[02:00]DOTA2英雄COSPLAY闹市街头巡游助威2015国际邀请赛
2015/08/02 DOTA
Python中使用第三方库xlrd来写入Excel文件示例
2015/04/05 Python
利用python获取某年中每个月的第一天和最后一天
2016/12/15 Python
Python中str is not callable问题详解及解决办法
2017/02/10 Python
Python中字典的浅拷贝与深拷贝用法实例分析
2018/01/02 Python
几种实用的pythonic语法实例代码
2018/02/24 Python
python中的内置函数max()和min()及mas()函数的高级用法
2018/03/29 Python
Python 读取某个目录下所有的文件实例
2018/06/23 Python
Python pandas DataFrame操作的实现代码
2019/06/21 Python
django的ORM操作 删除和编辑实现详解
2019/07/24 Python
python单例设计模式实现解析
2020/01/07 Python
Python json模块与jsonpath模块区别详解
2020/03/05 Python
python实现小程序推送页面收录脚本
2020/04/20 Python
French Connection官网:女装、男装及家居用品
2019/03/18 全球购物
优秀教师感人事迹材料
2014/05/04 职场文书
商务英语专业毕业生求职信
2014/07/06 职场文书
住房抵押登记委托书
2014/09/27 职场文书
2014年幼儿园班级工作总结
2014/12/17 职场文书
2015年试用期自我评价范文
2015/03/10 职场文书
微信小程序实现拍照和相册选取图片
2021/05/09 Javascript