转载：https://www.cnblogs.com/zongfa/p/7709639.html
用户表单是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
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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)</pre>
方法二：结合Model，继承django.forms.ModelForm
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">#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中指定的字段</pre>
](javascript:void(0); "复制代码")
在视图（view）中使用form
在view函数中使用form的一般情景是：
view.py:
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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})</pre>
](javascript:void(0); "复制代码")
contact.html:
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><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></pre>
](javascript:void(0); "复制代码")
处理表单数据
form.is_valid()返回true后，表单数据都被存储在form.cleaned_data对象中（字典类型，意为经过清洗的数据），而且数据会被自动转换为Python对象，如：在form中定义了DateTimeField，那么该字段将被转换为datetime类型，还有诸如：IntegerField、FloatField
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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</pre>
](javascript:void(0); "复制代码")
Form的简单使用方法就这些。 另：
在模版中显示表单的几种方式：
显示form找template中的方法多种多样，也可以自定义：
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><form action="/contact/" method="post">{% csrf_token %}
{{ form.as_p }} <input type="submit" value="Submit" />
</form></pre>
还可以使用form.as_table、form.as_ul，分别表示用<p>标签，<table>标签和<ul>表示显示表单。如果要自定义，你只要获取到每个元素的值就行：
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><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></pre>
](javascript:void(0); "复制代码")
每个form字段都可以使用 {{form.name_of_field}}得到。
也可以通过迭代form，每个迭代元素对应的是form里面的field
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><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></pre>
](javascript:void(0); "复制代码")
{{field}}有如下属性：
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">{{field.lable}}，如：Email address
{{field.label_tag}}，如： <label for=id_email>Email address</label> {{field.value}} 如：someone.@gmail.com
{{field.errors}}</pre>
实例：构建表单 第一步:首先在models.py中定义一个表单模型
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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='订阅该贴')</pre>
那个topic中的choices需要在models.py中定义一个数组.
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">TOPIC_CHOICES = (
('leve1', '差评'),
('leve2', '中评'),
('leve3', '好评'),
)</pre>
这样，之后在html显示的表单就采用这个模型的数据了。
另外还有一种定义表单模型的方式，那就是直接继承另一个models。如果我们在models里设计数据库时，已经设计好了一个类(就是数据库的表)之后想复用这个类的信息来作为表单的模型，那么很简单，同样是在models中的一个类
[
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">class Advertisement(models.Model): #订单编号
OrderID = models.ForeignKey(OrderInfo) #//广告标题#
Title = models.CharField(max_length = 36) #//广告内容#
Content = models.CharField(max_length = 600)</pre>
](javascript:void(0); "复制代码")
注意，他的类型是models.Model，是做数据库ORM用的。
然后怎么关联呢?
需要导入一个新的类 (ModelForm)
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">from django.forms import ModelForm class ContactForm(ModelForm): class Meta:
model = Advertisement
fields = ('Title', 'CustomerID')</pre>
这里的Advertisement就是之前那个ORM的模型。
第二步：OK，继续我们的表单，下一步需要做什么呢？开始在views.py里写对表单的调用吧.
def remark(request):
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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,
})</pre>
](javascript:void(0); "复制代码")
整个代码很简单，我就不过多的解释了。
第三步：我们知道django里任何访问都是通过urls.py来管理的。所以下面我们需要配置一个路径。
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">(r'^message', 'iring.views.remark'),</pre>
第四步：最后应该是建立一个模板的时候了，因为我们最终是输出到html上的.注意views的remark函数最后一行
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">return render_to_response('message.html', { 'form': form,
})</pre>
就是讲当前的表单对象输出到message.html里，自动生成一个表单。
所以，先构建一个html.
这个html模板很简单，除去不必要的CSS，我只给出核心部分好啦。
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;"><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></pre>
](javascript:void(0); "复制代码")
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">{% for field in form %}
{% endfor %}</pre>
用于对表单对象里的元素进行遍历，然后通过
<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; overflow-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">{{ field.label_tag }}
{{ field }}
{{ field.errors }}</pre>
这三个标签来输出，注意{{ field.errors }}默认情况下是不会输出的，只有当验证表单正确性时才会输出内容。
