Python的Django框架中forms表單類的使用方法詳解

用戶表單是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