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

更新时间：2016年06月21日 14:59:10 作者：刘一痕

用户表单是Web端的一项基本功能,大而全的Django框架中自然带有现成的基础form对象,Python的Django框架中forms表单类的使用方法详解

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来访问这个例子

2016621145313568.jpg (463×521)

2016621145344436.jpg (433×383)

2016621145405787.jpg (434×350)

您可能感兴趣的文章:

python全局变量引用与修改过程解析
这篇文章主要介绍了python全局变量引用与修改过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
tkinter高级布局之PanedWindow和notebook详解
本文主要介绍了tkinter中的两种布局控件,分别是可以动态划分子控件的PanedWindow,和提供了选项卡工具的notebook,感兴趣的小伙伴可以学习一下
2023-08-08
浅析python打包工具distutils、setuptools
python包在开发中十分常见，一般的使用套路是所有的功能做一个python模块包，打包模块，然后发布，安装使用。这篇文章给大家介绍了python打包工具distutils、setuptools的相关知识，感兴趣的朋友一起看看吧
2018-04-04
使用TensorFlow搭建一个全连接神经网络教程
今天小编就为大家分享一篇使用TensorFlow搭建一个全连接神经网络教程，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-02-02
Python爬虫Scrapy框架IP代理的配置与调试
在调试爬虫的时候，新手都会遇到关于ip的错误，本文就来介绍一下Python爬虫Scrapy框架IP代理的配置与调试，具有一定的参考价值，感兴趣的可以了解一下
2021-12-12
总结python中pass的作用
在本篇内容里我们给读者们分享了关于python中pass的作用以及相关实例代码，有需要的朋友们学习下。
2019-02-02
简单谈谈Python中的模块导入
Python 模块(Module),是一个 Python 文件,以 .py 结尾,包含了 Python对象定义和Python语句,下面这篇文章主要给大家介绍了关于Python模块导入的相关资料,需要的朋友可以参考下
2021-10-10
Python实现大文件排序的方法
这篇文章主要介绍了Python大文件排序的方法,涉及Python针对文件、缓存及日期等操作的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-07-07
python 获取图片中文字的四种办法
本文主要介绍了python 获取图片中文字的几种办法，主要使用光学字符识别（OCR）技术，本文主要介绍了4种第三方库，具有一定的参考价值，感兴趣的可以了解一下
2023-11-11
Python统计python文件中代码,注释及空白对应的行数示例【测试可用】
这篇文章主要介绍了Python统计python文件中代码,注释及空白对应的行数,涉及Python针对py文件的读取、遍历、判断、统计等相关操作技巧,需要的朋友可以参考下
2018-07-07