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

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

Form表单的功能

自动生成HTML表单元素

检查表单数据的合法性

如果验证错误，重新显示表单(数据不会重置)

数据类型转换(字符类型的数据转换成相应的Python类型)

Form相关的对象包括

Widget：用来渲染成HTML元素的工具，如：forms.Textarea对应HTML中的标签

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:

{% for field in form %}

{{field.label_tag}}:{{field}}

{{field.errors}}

{% endfor %}

处理表单数据

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中的方法多种多样，也可以自定义：

{% csrf_token %}

{{ form.as_p }}

还可以使用form.as_table、form.as_ul，分别表示用

标签，

• 表示显示表单。如果要自定义，你只要获取到每个元素的值就行：

{{ form.non_field_errors }}

{{ form.subject.errors }}

Email subject:

{{ form.subject }}

{{ form.message.errors }}

Your message:

{{ form.message }}

{{ form.sender.errors }}

Your email address:

{{ form.sender }}

{{ form.cc_myself.errors }}

CC yourself?

{{ form.cc_myself }}

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

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

{% for field in form %}

{{ field.errors }}

{{ field.label_tag }}: {{ field }}

{% endfor %}

{{field}}有如下属性：

{{field.lable}}，如：Email address

{{field.label_tag}}，如： Email address

{{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，我只给出核心部分好啦。

{% for field in form %}

{{ field.label_tag }}:{{ field }}

{{ field.errors }}

div>

{% endfor %}

p>div>

form>

{% for field in form %}

{% endfor %}

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

{{ field.label_tag }}

{{ field }}

{{ field.errors }}

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

最终我们通过:

http://youdjangourl/message来访问这个例子