用戶表單是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 = Contactfield = ('title','content') #只顯示model中指定的字段

在視圖（view）中使用form

在view函數中使用form的一般情景是：

view.py:

form django.shortcuts import render
form django.http import HttpResponseRedirectdef 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_mailsend_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 ModelFormclass ContactForm(ModelForm):class Meta:model = Advertisementfields = ('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://www.jb51.net/article/87046.htm