用戶表單是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://www.jb51.net/article/87046.htm