快捷導(dǎo)航

詳解Django中的form庫的使用

更新時間：2015年07月18日 09:34:37 投稿：goldensun

這篇文章主要介紹了詳解Django中的form庫的使用,Django是最為著名的Python編程框架,需要的朋友可以參考下

Django帶有一個form庫，稱為django.forms，這個庫可以處理我們本章所提到的包括HTML表單顯示以及驗證。接下來我們來深入了解一下form庫，并使用她來重寫contact表單應(yīng)用。

Django的newforms庫

在Django社區(qū)上會經(jīng)?？吹絛jango.newforms這個詞語。當(dāng)人們討論django.newforms，其實就是我們本章里面介紹的django.forms。

改名其實有歷史原因的。當(dāng)Django一次向公眾發(fā)行時，它有一個復(fù)雜難懂的表單系統(tǒng)：django.forms。后來它被完全重寫了，新的版本改叫作：django.newforms，這樣人們還可以通過名稱，使用舊版本。當(dāng)Django 1.0發(fā)布時，舊版本django.forms就不再使用了，而django.newforms也終于可以名正言順的叫做：django.forms。

表單框架最主要的用法是，為每一個將要處理的HTML的`` <Form>`` 定義一個Form類。在這個例子中，我們只有一個`` <Form>`` ，因此我們只需定義一個Form類。這個類可以存在于任何地方，甚至直接寫在`` views.py`` 文件里也行，但是社區(qū)的慣例是把Form類都放到一個文件中：forms.py。在存放`` views.py`` 的目錄中，創(chuàng)建這個文件，然后輸入：

from django import forms

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

這看上去簡單易懂，并且很像在模塊中使用的語法。表單中的每一個字段（域）作為Form類的屬性，被展現(xiàn)成Field類。這里只用到CharField和EmailField類型。每一個字段都默認(rèn)是必填。要使email成為可選項，我們需要指定required=False。

讓我們鉆研到Python解釋器里面看看這個類做了些什么。它做的第一件事是將自己顯示成HTML：

>>> from contact.forms import ContactForm
>>> f = ContactForm()
>>> print f
<tr><th><label for="id_subject">Subject:</label></th><td><input type="text" name="subject" id="id_subject" /></td></tr>
<tr><th><label for="id_email">Email:</label></th><td><input type="text" name="email" id="id_email" /></td></tr>
<tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" /></td></tr>

為了便于訪問，Django用`` <label>`` 標(biāo)志，為每一個字段添加了標(biāo)簽。這個做法使默認(rèn)行為盡可能合適。

默認(rèn)輸出按照HTML的<`` table`` >格式，另外有一些其它格式的輸出：

>>> print f.as_ul()
<li><label for="id_subject">Subject:</label> <input type="text" name="subject" id="id_subject" /></li>
<li><label for="id_email">Email:</label> <input type="text" name="email" id="id_email" /></li>
<li><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" /></li>
>>> print f.as_p()
<p><label for="id_subject">Subject:</label> <input type="text" name="subject" id="id_subject" /></p>
<p><label for="id_email">Email:</label> <input type="text" name="email" id="id_email" /></p>
<p><label for="id_message">Message:</label> <input type="text" name="message" id="id_message" /></p>

請注意，標(biāo)簽<table>、<ul>、<form>的開閉合標(biāo)記沒有包含于輸出當(dāng)中，這樣你就可以添加額外的行或者自定義格式。

這些類方法只是一般情況下用于快捷顯示完整表單的方法。你同樣可以用HTML顯示個別字段：

>>> print f['subject']
<input type="text" name="subject" id="id_subject" />
>>> print f['message']
<input type="text" name="message" id="id_message" />

Form對象做的第二件事是校驗數(shù)據(jù)。為了校驗數(shù)據(jù)，我們創(chuàng)建一個新的對Form象，并且傳入一個與定義匹配的字典類型數(shù)據(jù)：

>>> f = ContactForm({'subject': 'Hello', 'email': 'adrian@example.com', 'message': 'Nice site!'})

一旦你對一個Form實體賦值，你就得到了一個綁定form：

>>> f.is_bound
True

調(diào)用任何綁定form的is_valid()方法，就可以知道它的數(shù)據(jù)是否合法。我們已經(jīng)為每個字段傳入了值，因此整個Form是合法的：

>>> f.is_valid()
True

如果我們不傳入email值，它依然是合法的。因為我們指定這個字段的屬性required=False：

>>> f = ContactForm({'subject': 'Hello', 'message': 'Nice site!'})
>>> f.is_valid()
True

但是，如果留空subject或message，整個Form就不再合法了：

>>> f = ContactForm({'subject': 'Hello'})
>>> f.is_valid()
False
>>> f = ContactForm({'subject': 'Hello', 'message': ''})
>>> f.is_valid()
False

你可以逐一查看每個字段的出錯消息：

>>> f = ContactForm({'subject': 'Hello', 'message': ''})
>>> f['message'].errors
[u'This field is required.']
>>> f['subject'].errors
[]
>>> f['email'].errors
[]

每一個邦定Form實體都有一個errors屬性，它為你提供了一個字段與錯誤消息相映射的字典表。

>>> f = ContactForm({'subject': 'Hello', 'message': ''})
>>> f.errors
{'message': [u'This field is required.']}

最終，如果一個Form實體的數(shù)據(jù)是合法的，它就會有一個可用的cleaned_data屬性。這是一個包含干凈的提交數(shù)據(jù)的字典。 Django的form框架不但校驗數(shù)據(jù)，它還會把它們轉(zhuǎn)換成相應(yīng)的Python類型數(shù)據(jù)，這叫做清理數(shù)據(jù)。

>>> f = ContactForm({subject': Hello, email: adrian@example.com, message: Nice site!})
>>> f.is_valid()
True
>>> f.cleaned_data
{message': uNice site!, email: uadrian@example.com, subject: uHello}

我們的contact form只涉及字符串類型，它們會被清理成Unicode對象。如果我們使用整數(shù)型或日期型，form框架會確保方法使用合適的Python整數(shù)型或datetime.date型對象。

您可能感興趣的文章: