# views.py

from django.shortcuts import render_to_response
from mysite.contact.forms import ContactForm

def contact(request):
  if request.method == 'POST':
    form = ContactForm(request.POST)
    if form.is_valid():
      cd = form.cleaned_data
      send_mail(
        cd['subject'],
        cd['message'],
        cd.get('email', 'noreply@example.com'),
        ['siteowner@example.com'],
      )
      return HttpResponseRedirect('/contact/thanks/')
  else:
    form = ContactForm()
  return render_to_response('contact_form.html', {'form': form})

 
# contact_form.html

<html>
<head>
  <title>Contact us</title>
</head>
<body>
  <h1>Contact us</h1>

  {% if form.errors %}
    <p style="color: red;">
      Please correct the error{{ form.errors|pluralize }} below.
    </p>
  {% endif %}

  <form action="" method="post">
    <table>
      {{ form.as_table }}
    </table>
    <input type="submit" value="Submit">
  </form>
</body>
</html>

看看，我們能移除這么多不整齊的代碼！ Django的forms框架處理HTML顯示、數(shù)據(jù)校驗、數(shù)據(jù)清理和表單錯誤重現(xiàn)。

嘗試在本地運行。裝載表單，先留空所有字段提交空表單；繼而填寫一個錯誤的郵箱地址再嘗試提交表單；最后再用正確數(shù)據(jù)提交表單。（根據(jù)服務(wù)器的設(shè)置，當(dāng)send_mail()被調(diào)用時，你將得到一個錯誤提示。而這是另一個問題。）
改變字段顯示

你可能首先注意到：當(dāng)你在本地顯示這個表單的時，message字段被顯示成`` input type=”text”`` ，而它應(yīng)該被顯示成<`` textarea`` >。我們可以通過設(shè)置* widget* 來修改它：

from django import forms

class ContactForm(forms.Form):
  subject = forms.CharField()
  email = forms.EmailField(required=False)
  message = forms.CharField(**widget=forms.Textarea** )

forms框架把每一個字段的顯示邏輯分離到一組部件（widget）中。每一個字段類型都擁有一個默認(rèn)的部件，我們也可以容易地替換掉默認(rèn)的部件，或者提供一個自定義的部件。

考慮一下Field類表現(xiàn)* 校驗邏輯* ，而部件表現(xiàn)* 顯示邏輯* 。
設(shè)置最大長度

一個最經(jīng)常使用的校驗要求是檢查字段長度。另外，我們應(yīng)該改進(jìn)ContactForm，使subject限制在100個字符以內(nèi)。為此，僅需為CharField提供max_length參數(shù)，像這樣：

from django import forms

class ContactForm(forms.Form):
  subject = forms.CharField(**max_length=100** )
  email = forms.EmailField(required=False)
  message = forms.CharField(widget=forms.Textarea)

選項min_length參數(shù)同樣可用。
設(shè)置初始值

讓我們再改進(jìn)一下這個表單：為字subject段添加* 初始值* ： "I love your site!" （一點建議，但沒壞處。）為此，我們可以在創(chuàng)建Form實體時，使用initial參數(shù)：

def contact(request):
  if request.method == 'POST':
    form = ContactForm(request.POST)
    if form.is_valid():
      cd = form.cleaned_data
      send_mail(
        cd['subject'],
        cd['message'],
        cd.get('email', `'noreply@example.com`_'),
        [`'siteowner@example.com`_'],
      )
      return HttpResponseRedirect('/contact/thanks/')
  else:
    form = ContactForm(
      **initial={'subject': 'I love your site!'}**
    )
  return render_to_response('contact_form.html', {'form': form})

現(xiàn)在，subject字段將被那個句子填充。

請注意，傳入* 初始值* 數(shù)據(jù)和傳入數(shù)據(jù)以* 綁定* 表單是有區(qū)別的。最大的區(qū)別是，如果僅傳入* 初始值* 數(shù)據(jù)，表單是unbound的，那意味著它沒有錯誤消息。
自定義校驗規(guī)則

假設(shè)我們已經(jīng)發(fā)布了反饋頁面了，email已經(jīng)開始源源不斷地涌入了。這里有一個問題：一些提交的消息只有一兩個字，我們無法得知詳細(xì)的信息。所以我們決定增加一條新的校驗：來點專業(yè)精神，最起碼寫四個字，拜托。

我們有很多的方法把我們的自定義校驗掛在Django的form上。如果我們的規(guī)則會被一次又一次的使用，我們可以創(chuàng)建一個自定義的字段類型。大多數(shù)的自定義校驗都是一次性的，可以直接綁定到form類.

我們希望`` message`` 字段有一個額外的校驗，我們增加一個`` clean_message()`` 方法到`` Form`` 類：

from django import forms

class ContactForm(forms.Form):
  subject = forms.CharField(max_length=100)
  email = forms.EmailField(required=False)
  message = forms.CharField(widget=forms.Textarea)

  def clean_message(self):
    message = self.cleaned_data['message']
    num_words = len(message.split())
    if num_words < 4:
      raise forms.ValidationError("Not enough words!")
    return message

Django的form系統(tǒng)自動尋找匹配的函數(shù)方法，該方法名稱以clean_開頭，并以字段名稱結(jié)束。如果有這樣的方法，它將在校驗時被調(diào)用。

特別地，clean_message()方法將在指定字段的默認(rèn)校驗邏輯執(zhí)行* 之后* 被調(diào)用。（本例中，在必填CharField這個校驗邏輯之后。）因為字段數(shù)據(jù)已經(jīng)被部分處理，所以它被從self.cleaned_data中提取出來了。同樣，我們不必?fù)?dān)心數(shù)據(jù)是否為空，因為它已經(jīng)被校驗過了。

我們簡單地使用了len()和split()的組合來計算單詞的數(shù)量。如果用戶輸入字?jǐn)?shù)不足，我們拋出一個forms.ValidationError型異常。這個異常的描述會被作為錯誤列表中的一項顯示給用戶。

在函數(shù)的末尾顯式地返回字段的值非常重要。我們可以在我們自定義的校驗方法中修改它的值（或者把它轉(zhuǎn)換成另一種Python類型）。如果我們忘記了這一步，None值就會返回，原始的數(shù)據(jù)就丟失掉了。
指定標(biāo)簽

HTML表單中自動生成的標(biāo)簽?zāi)J(rèn)是按照規(guī)則生成的：用空格代替下劃線，首字母大寫。如email的標(biāo)簽是"Email" 。（好像在哪聽到過？是的，同樣的邏輯被用于模塊（model）中字段的verbose_name值。我們在第五章談到過。）

像在模塊中做過的那樣，我們同樣可以自定義字段的標(biāo)簽。僅需使用label，像這樣：

class ContactForm(forms.Form):
  subject = forms.CharField(max_length=100)
  email = forms.EmailField(required=False, **label='Your e-mail address'** )
  message = forms.CharField(widget=forms.Textarea)

您可能感興趣的文章: