Python的Django框架中forms表单类的使用方法详解


Posted in Python onJune 21, 2016

Form表单的功能

  • 自动生成HTML表单元素
  • 检查表单数据的合法性
  • 如果验证错误,重新显示表单(数据不会重置)
  • 数据类型转换(字符类型的数据转换成相应的Python类型)

Form相关的对象包括

  • Widget:用来渲染成HTML元素的工具,如:forms.Textarea对应HTML中的<textarea>标签
  • Field:Form对象中的一个字段,如:EmailField表示email字段,如果这个字段不是有效的email格式,就会产生错误。
  • Form:一系列Field对象的集合,负责验证和显示HTML元素
  • Form Media:用来渲染表单的CSS和JavaScript资源。

Form Objects

Form对象封装了一系列Field和验证规则,Form类都必须直接或间接继承自django.forms.Form,定义Form有两种方式:

方法一:直接继承Form

from django import forms
class ContactForm(forms.Form):
 subject = forms.CharField(max_length=100,label='主题')
 message = form.CharField(widget=forms.TextArea)
 sender = form.EmailField()
 cc_myself = forms.BooleanField(required=False)

方法二:结合Model,继承django.forms.ModelForm

#models.py
class Contact(models.Model):
 title = models.CharField(max_length=30)
 content = models.CharField(max_length=20)

#form.py
class ConotactForm(ModelForm):
 class Meta:
 model = Contact
 field = ('title','content') #只显示model中指定的字段

在视图(view)中使用form

在view函数中使用form的一般情景是:

view.py:

form django.shortcuts import render
form django.http import HttpResponseRedirect

def contact(request):
 if request.method=="POST":
  form = ContactForm(request.POST)
  if form.is_valid(): #所有验证都通过
   #do something处理业务
   return HttpResponseRedirect('/')
 else:
  form = ContactForm()
 return render(request,'contact.html',{'form':form})

contact.html:

<form action='/contact/' method='POST'>
 {% for field in form %}
  <div class = 'fieldWrapper'>
   {{field.label_tag}}:{{field}}
   {{field.errors}}
  </div>
 {% endfor %}
 <div class='fieldWrapper'> <p><input type='submit' value='留言'></p></div>
</form>

处理表单数据

form.is_valid()返回true后,表单数据都被存储在form.cleaned_data对象中(字典类型,意为经过清洗的数据),而且数据会被自动转换为Python对象,如:在form中定义了DateTimeField,那么该字段将被转换为datetime类型,还有诸如:IntegerField、FloatField

if form.is_valid():
 subject = form.cleaned_data['subject']
 message = form.cleaned_data['message']
 sender = form.cleaned_data['sender']
 cc_myself = form.cleaned_data['cc_myself']

 recipients = ['info@example.com']
 if cc_myself:
  recipients.append(sender)

 from django.core.mail import send_mail
 send_mail(subject, message, sender, recipients)
 return HttpResponseRedirect('/thanks/') # Redirect after POST

Form的简单使用方法就这些。 另:

在模版中显示表单的几种方式:

显示form找template中的方法多种多样,也可以自定义:

<form action="/contact/" method="post">{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="Submit" />
</form>

还可以使用form.as_table、form.as_ul,分别表示用<p>标签,<table>标签和<ul>表示显示表单。如果要自定义,你只要获取到每个元素的值就行:

<form action="/contact/" method="post">
 {{ form.non_field_errors }}
 <div class="fieldWrapper">
  {{ form.subject.errors }}
  <label for="id_subject">Email subject:</label>
  {{ form.subject }}
 </div>
 <div class="fieldWrapper">
  {{ form.message.errors }}
  <label for="id_message">Your message:</label>
  {{ form.message }}
 </div>
 <div class="fieldWrapper">
  {{ form.sender.errors }}
  <label for="id_sender">Your email address:</label>
  {{ form.sender }}
 </div>
 <div class="fieldWrapper">
  {{ form.cc_myself.errors }}
  <label for="id_cc_myself">CC yourself?</label>
  {{ form.cc_myself }}
 </div>
 <p><input type="submit" value="Send message" /></p>
</form>

每个form字段都可以使用 {{form.name_of_field}}得到。

也可以通过迭代form,每个迭代元素对应的是form里面的field

<form action="/contact/" method="post">
 {% for field in form %}
  <div class="fieldWrapper">
   {{ field.errors }}
   {{ field.label_tag }}: {{ field }}
  </div>
 {% endfor %}
 <p><input type="submit" value="Send message" /></p>
</form>

{{field}}有如下属性:

{{field.lable}},如:Email address
{{field.label_tag}},如: <label for=id_email>Email address</label>
{{field.value}} 如:someone.@gmail.com
{{field.errors}}

实例:构建表单
第一步:首先在models.py中定义一个表单模型

class RemarkForm(forms.Form):
  subject = forms.CharField(max_length=100 ,label='留言标题')
  mail = forms.EmailField(label='电子邮件')
  topic = forms.ChoiceField(choices=TOPIC_CHOICES,label='选择评分') 
  message = forms.CharField(label='留言内容',widget=forms.Textarea)
  cc_myself = forms.BooleanField(required=False ,label='订阅该贴')

那个topic中的choices需要在models.py中定义一个数组.

TOPIC_CHOICES = (
  ('leve1', '差评'),
  ('leve2', '中评'),
  ('leve3', '好评'),
)

这样,之后在html显示的表单就采用这个模型的数据了。

另外还有一种定义表单模型的方式,那就是直接继承另一个models。如果我们在models里设计数据库时,已经设计好了一个类(就是数据库的表)之后想复用这个类的信息来作为表单的模型,那么很简单,同样是在models中的一个类

class Advertisement(models.Model): 
 #订单编号
 OrderID =  models.ForeignKey(OrderInfo)
 #//广告标题#
 Title = models.CharField(max_length = 36) 
 #//广告内容#
 Content = models.CharField(max_length = 600)

注意,他的类型是models.Model,是做数据库ORM用的。

然后怎么关联呢?
需要导入一个新的类 (ModelForm)

from django.forms import ModelForm

class ContactForm(ModelForm):
 class Meta:
 model = Advertisement
 fields = ('Title', 'CustomerID')

这里的Advertisement就是之前那个ORM的模型。
第二步:OK,继续我们的表单,下一步需要做什么呢?开始在views.py里写对表单的调用吧.
def remark(request):

if request.method == 'POST': # 如果表单被提交
    form = ContactForm(request.POST) # 获取Post表单数据
    if form.is_valid(): # 验证表单
      return HttpResponseRedirect('/') # 跳转
  else:
    form = ContactForm() #获得表单对象
    
  return render_to_response('message.html', {
    'form': form,
  })

整个代码很简单,我就不过多的解释了。

第三步:我们知道django里任何访问都是通过urls.py来管理的。所以下面我们需要配置一个路径。

(r'^message', 'iring.views.remark'),

第四步:最后应该是建立一个模板的时候了,因为我们最终是输出到html上的.注意views的remark函数最后一行

return render_to_response('message.html', {
    'form': form,
  })

就是讲当前的表单对象输出到message.html里,自动生成一个表单。
所以,先构建一个html.
这个html模板很简单,除去不必要的CSS,我只给出核心部分好啦。

<form action="/message/" method="POST">
 {% for field in form %}
  <div class="fieldWrapper">
   {{ field.label_tag }}:{{ field }} 
   {{ field.errors }}
  div>
 {% endfor %}
 <div class="fieldWrapper"><p><input type="submit" value="留言" />p>div>
 form>
{% for field in form %}

{% endfor %}

用于对表单对象里的元素进行遍历,然后通过

{{ field.label_tag }}
{{ field }} 
{{ field.errors }}

这三个标签来输出,注意{{ field.errors }}默认情况下是不会输出的,只有当验证表单正确性时才会输出内容。

最终我们通过:
http://youdjangourl/message来访问这个例子

Python的Django框架中forms表单类的使用方法详解

Python的Django框架中forms表单类的使用方法详解

Python的Django框架中forms表单类的使用方法详解

Python 相关文章推荐
Python中几种导入模块的方式总结
Apr 27 Python
windows环境下tensorflow安装过程详解
Mar 30 Python
快速解决安装python没有scripts文件夹的问题
Apr 03 Python
django 修改server端口号的方法
May 14 Python
pandas.loc 选取指定列进行操作的实例
May 18 Python
Python判断字符串是否为字母或者数字(浮点数)的多种方法
Aug 03 Python
分享一个pycharm专业版安装的永久使用方法
Sep 24 Python
10行Python代码计算汽车数量的实现方法
Oct 23 Python
python实现简单图书管理系统
Nov 22 Python
python  ceiling divide 除法向上取整(或小数向上取整)的实例
Dec 27 Python
解决python图像处理图像赋值后变为白色的问题
Jun 04 Python
opencv深入浅出了解机器学习和深度学习
Mar 17 Python
Python正则表达式使用经典实例
Jun 21 #Python
常见的python正则用法实例讲解
Jun 21 #Python
实例讲解Python的函数闭包使用中应注意的问题
Jun 20 #Python
Python中的数学运算操作符使用进阶
Jun 20 #Python
Python中在for循环中嵌套使用if和else语句的技巧
Jun 20 #Python
解析Python中的生成器及其与迭代器的差异
Jun 20 #Python
Python判断列表是否已排序的各种方法及其性能分析
Jun 20 #Python
You might like
Android ProgressBar进度条和ProgressDialog进度框的展示DEMO
2013/06/19 PHP
让PHP显示Facebook的粉丝数量方法
2014/01/08 PHP
PHP中array_slice函数用法实例详解
2014/11/25 PHP
基于JQuery的数字改变的动画效果--可用来做计数器
2010/08/11 Javascript
分享几个超级震憾的图片特效
2012/01/08 Javascript
多次注册事件会导致一个事件被触发多次的解决方法
2013/08/12 Javascript
js/jquery判断浏览器的方法小结
2014/09/02 Javascript
js命名空间写法示例
2015/12/18 Javascript
详解JS中的attribute属性
2017/04/25 Javascript
vue.js $refs和$emit 父子组件交互的方法
2017/12/20 Javascript
vue树形结构获取键值的方法示例
2018/06/21 Javascript
webpack+vue-cil中proxyTable处理跨域的方法
2018/07/20 Javascript
Vue文件配置全局变量的实例
2018/09/06 Javascript
微信小程序云开发之使用云数据库
2019/05/17 Javascript
微信小程序用户授权弹窗 拒绝时引导用户重新授权实现
2019/07/29 Javascript
微信用户访问小程序的登录过程详解
2019/09/20 Javascript
复制粘贴功能的Python程序
2008/04/04 Python
python正则匹配查询港澳通行证办理进度示例分享
2013/12/27 Python
Python yield与实现方法代码分析
2018/02/06 Python
python opencv 简单阈值算法的实现
2019/08/04 Python
python如果快速判断数字奇数偶数
2019/11/13 Python
css3 position fixed固定居中问题解决方案
2014/08/19 HTML / CSS
The Hut英国:英国领先的豪华在线百货商店
2019/07/26 全球购物
英国在线照明超市:Castlegate Lights
2019/10/30 全球购物
linux系统都有哪些运行级别
2012/04/15 面试题
shell程序中如何注释
2012/02/17 面试题
素食餐饮项目创业计划书
2014/02/02 职场文书
小学毕业典礼主持词
2014/03/27 职场文书
租房协议书怎么写
2014/04/10 职场文书
整改报告怎么写
2014/11/06 职场文书
2014年社区教育工作总结
2014/12/02 职场文书
2014年技术部工作总结
2014/12/12 职场文书
离婚协议书范文2014(夫妻感情破裂)
2014/12/14 职场文书
大学迎新生的欢迎词
2019/06/25 职场文书
浏览器常用基本操作之python3+selenium4自动化测试(基础篇3)
2021/05/21 Python
游戏《我的世界》澄清Xbox版暂无计划加入光追
2022/04/03 其他游戏